Theme
On this page (4)
Component Skill — components/tag-list/component-skill.md

Native basis

A <ul aria-label="Tags"> of tag links; the colored variant sets --mk-tag-color per tag.

Web Platform APIs

color-mix()

Classes

.mk-tag-list

Data attributes

data-variant: plain, colored; --mk-tag-color.

§Default

A labelled list of outlined tag chips.

§Plain

data-variant='plain': hashtags - the # is drawn by CSS with empty alt text, so it is not read out.

§Colored

data-variant='colored': each tag tinted by its own --mk-tag-color.

§CSS view file

/* -- Tag List (website · Search & Navigation) -----------------------------
   Displays the tags associated with a content item - outlined chips, plain hashtags, or colored labels. */
@layer components {
  /* every box in the block measures border-box - the same on any page */
  :where(.mk-tag-list, .mk-tag-list *, .mk-tag-list ::before, .mk-tag-list ::after) { box-sizing: border-box; }
  .mk-tag-list { display: flex; flex-wrap: wrap; gap: 0.375rem; margin: 0; padding: 0; list-style: none;
    & a { display: inline-flex; align-items: center; height: 1.5rem; padding-inline: 0.625rem; border: 1px solid var(--border); border-radius: 999px; color: var(--foreground); font-size: 0.75rem; font-weight: 500; text-decoration: none; }
    & a:hover { border-color: color-mix(in oklch, var(--foreground) 40%, var(--border)); }
    & a:focus-visible { outline: 2px solid var(--ring); outline-offset: 2px; }
  }
  .mk-tag-list[data-variant="plain"] { gap: 0.25rem 0.75rem;
    & a { height: auto; padding: 0; border: 0; color: var(--primary); font-size: 0.875rem; }
    & a::before { content: "#" / ""; opacity: 0.6; }
    & a:hover { text-decoration: underline; text-underline-offset: 3px; }
  }
  .mk-tag-list[data-variant="colored"] a {
    --mk-tag-color: var(--muted-foreground);
    border-color: transparent;
    border-radius: var(--radius-sm);
    background: color-mix(in oklch, var(--mk-tag-color) 14%, transparent);
    color: color-mix(in oklab, var(--mk-tag-color) 75%, var(--foreground));
  }
  /* -- Accessibility ------------------------------------------- */
  @media (forced-colors: active) {
    .mk-tag-list a { border: 1px solid LinkText; }
  }
}

Comments, ideas or improvements? Edit this page's source on GitHub