Theme
Design your own
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