Timace

Tag

Design
React
Accessibility
Install
npm install react-aria-components
components/ui/tag.tsx
"use client";

import type { ReactNode } from "react";
import { Button, Label, Tag as AriaTag, TagGroup as AriaTagGroup, TagList, type TagGroupProps as AriaTagGroupProps, type TagProps as AriaTagProps } from "react-aria-components";

const styles = {
  root: "flex flex-col gap-(--tui-tag-label-gap) font-(family-name:--tui-font)",
  label: "text-(length:--tui-tag-label-size) leading-none font-medium text-(--tui-tag-label)",
  list: "flex flex-wrap gap-(--tui-tag-gap)",
  tag: "inline-flex h-(--tui-tag-height) cursor-default items-center gap-1 rounded-(--tui-tag-radius) border-solid border-(length:--tui-tag-border-width) border-(--tui-tag-border) bg-(--tui-tag-bg) px-(--tui-tag-padding-x) text-(length:--tui-tag-font-size) leading-none font-(--tui-tag-font-weight) whitespace-nowrap text-(--tui-tag-fg) outline-none transition-colors duration-(--tui-duration) data-disabled:opacity-(--tui-tag-disabled-opacity) data-focus-visible:[outline:var(--tui-tag-ring-width)_solid_var(--tui-tag-ring)] data-focus-visible:[outline-offset:var(--tui-tag-ring-offset)] data-hovered:bg-(--tui-tag-bg-hover) data-selected:border-(--tui-tag-selected-bg) data-selected:bg-(--tui-tag-selected-bg)! data-selected:text-(--tui-tag-selected-fg)",
  remove: "-mr-1 flex size-4 cursor-default items-center justify-center rounded-full opacity-60 outline-none data-focus-visible:[outline:2px_solid_var(--tui-tag-ring)] data-hovered:opacity-100",
};

export interface TagGroupProps extends Omit<AriaTagGroupProps, "className" | "children"> {
  label?: string;
  children: ReactNode;
  className?: string;
}

/** A set of tags. Give it onRemove and each tag gets a button that removes it. */
export function TagGroup({ label, children, className, ...props }: TagGroupProps) {
  return (
    <AriaTagGroup {...props} className={[styles.root, className].filter(Boolean).join(" ")}>
      {label && <Label className={styles.label}>{label}</Label>}
      <TagList className={styles.list}>{children}</TagList>
    </AriaTagGroup>
  );
}

export interface TagProps extends Omit<AriaTagProps, "className" | "children"> {
  children: ReactNode;
  className?: string;
}

export function Tag({ children, className, ...props }: TagProps) {
  const textValue = typeof children === "string" ? children : undefined;
  return (
    <AriaTag data-slot="tag" textValue={textValue} {...props} className={[styles.tag, className].filter(Boolean).join(" ")}>
      {({ allowsRemoving }) => (
        <>
          {children}
          {allowsRemoving && (
            <Button slot="remove" className={styles.remove}>
              <svg aria-hidden viewBox="0 0 16 16" fill="none" stroke="currentColor" strokeWidth="2" strokeLinecap="round" className="size-3">
                <path d="M4 4l8 8M12 4l-8 8" />
              </svg>
            </Button>
          )}
        </>
      )}
    </AriaTag>
  );
}
styles/timace-ui.css
:root {
  color-scheme: light;
  --tui-bg: #ffffff;
  --tui-fg: #0a0a0a;
  --tui-muted: #f5f5f5;
  --tui-muted-fg: #737373;
  --tui-border: #e5e5e5;
  --tui-primary: #171717;
  --tui-primary-fg: #fafafa;
  --tui-ring: #a3a3a3;
  --tui-success: #16a34a;
  --tui-warning: #d97706;
  --tui-danger: #dc2626;
  --tui-radius: 8px;
  --tui-border-width: 1px;
  --tui-space: 4px;
  --tui-shadow: none;
  --tui-font: ui-sans-serif, system-ui, -apple-system, "Segoe UI", sans-serif;
  --tui-text: 14px;
  --tui-duration: 150ms;

  /* Tag */
  --tui-tag-height: calc(var(--tui-space) * 6.5);
  --tui-tag-padding-x: calc(var(--tui-space) * 2.5);
  --tui-tag-gap: calc(var(--tui-space) * 1.5);
  --tui-tag-label-gap: calc(var(--tui-space) * 2);
  --tui-tag-radius: 999px;
  --tui-tag-border-width: var(--tui-border-width);
  --tui-tag-font-size: 13px;
  --tui-tag-label-size: 13px;
  --tui-tag-font-weight: 500;
  --tui-tag-bg: var(--tui-bg);
  --tui-tag-fg: var(--tui-fg);
  --tui-tag-border: var(--tui-border);
  --tui-tag-label: var(--tui-fg);
  --tui-tag-bg-hover: var(--tui-muted);
  --tui-tag-selected-bg: var(--tui-primary);
  --tui-tag-selected-fg: var(--tui-primary-fg);
  --tui-tag-ring: var(--tui-ring);
  --tui-tag-ring-width: 2px;
  --tui-tag-ring-offset: 2px;
  --tui-tag-disabled-opacity: 0.5;
}

.dark,
[data-theme="dark"] {
  color-scheme: dark;
  --tui-bg: #0a0a0a;
  --tui-fg: #fafafa;
  --tui-muted: #1c1c1c;
  --tui-muted-fg: #a3a3a3;
  --tui-border: #2a2a2a;
  --tui-primary: #fafafa;
  --tui-primary-fg: #171717;
  --tui-ring: #737373;
  --tui-success: #22c55e;
  --tui-warning: #f59e0b;
  --tui-danger: #ef4444;
}

Needs Tailwind CSS v4. Import the stylesheet once, after Tailwind.