List

npm install react-aria-components

"use client";

import type { ComponentProps, ReactNode } from "react";
import { Button, type ButtonProps } from "react-aria-components";

const join = (...classes: (string | undefined)[]) => classes.filter(Boolean).join(" ");

const row =
  "flex min-h-(--tui-list-item-height) w-full items-center gap-(--tui-list-item-gap) rounded-(--tui-list-item-radius) border-none bg-transparent px-(--tui-list-item-padding-x) py-2 text-left font-(family-name:--tui-font) text-(length:--tui-list-font-size) leading-snug text-(--tui-list-fg)";

/** A floating panel of rows: settings, an account menu, a set of places to go. */
export function List({ title, className, children, ...props }: Omit<ComponentProps<"div">, "title"> & { /** A quiet heading over the rows. */ title?: ReactNode }) {
  return (
    <div data-slot="list" {...props} className={join("flex flex-col gap-(--tui-list-gap) rounded-(--tui-list-radius) bg-(--tui-list-bg) p-(--tui-list-padding) font-(family-name:--tui-font) shadow-(--tui-list-shadow)", className)}>
      {title && <div className="px-(--tui-list-item-padding-x) pt-2 pb-1 text-(length:--tui-list-title-size) leading-none font-medium text-(--tui-list-title)">{title}</div>}
      <div role="list" className="flex flex-col gap-(--tui-list-gap)">
        {children}
      </div>
    </div>
  );
}

export interface ListItemProps extends Omit<ButtonProps, "className" | "children" | "value"> {
  /** Goes in a round mark before the label. */
  icon?: ReactNode;
  /** A quieter line under the label. */
  description?: ReactNode;
  /** What the row is set to, at its end: a value, a badge, a switch. */
  value?: ReactNode;
  children: ReactNode;
  className?: string;
}

/**
 * One row. With `onPress` it is a button, with an arrow at its end to say it
 * goes somewhere. Without, it only shows something, and can hold a control
 * of its own in `value`.
 */
export function ListItem({ icon, description, value, children, className, ...props }: ListItemProps) {
  const pressable = Boolean(props.onPress);
  const inner = (
    <>
      {icon && (
        <span aria-hidden className="flex size-(--tui-list-icon-size) shrink-0 items-center justify-center rounded-full bg-(--tui-list-icon-bg) text-(--tui-list-icon-fg) [&_svg]:size-[56%]">
          {icon}
        </span>
      )}
      <span className="flex min-w-0 flex-1 flex-col gap-0.5">
        <span className="truncate">{children}</span>
        {description && <span className="truncate text-[0.9em] text-(--tui-list-muted)">{description}</span>}
      </span>
      {value !== undefined && <span className="flex shrink-0 items-center text-(--tui-list-muted)">{value}</span>}
      {pressable && (
        <svg aria-hidden viewBox="0 0 16 16" fill="none" stroke="currentColor" strokeWidth="1.75" strokeLinecap="round" strokeLinejoin="round" className="size-4 shrink-0 text-(--tui-list-chevron)">
          <path d="M6 3.500L10.500 8 6 12.500" />
        </svg>
      )}
    </>
  );
  return (
    <div role="listitem" data-slot="list-item">
      {pressable ? (
        <Button
          {...props}
          className={join(
            row,
            "cursor-default outline-none transition-colors duration-(--tui-duration) data-disabled:opacity-50 data-focus-visible:[outline:var(--tui-list-ring-width)_solid_var(--tui-list-ring)] data-hovered:bg-(--tui-list-item-bg-hover) data-pressed:bg-(--tui-list-item-bg-hover)",
            className,
          )}
        >
          {inner}
        </Button>
      ) : (
        <div className={join(row, className)}>{inner}</div>
      )}
    </div>
  );
}

: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;

  /* List */
  --tui-list-padding: calc(var(--tui-space) * 2);
  --tui-list-gap: calc(var(--tui-space) * 0.5);
  --tui-list-item-height: calc(var(--tui-space) * 13);
  --tui-list-item-padding-x: calc(var(--tui-space) * 3);
  --tui-list-item-gap: calc(var(--tui-space) * 3.5);
  --tui-list-icon-size: calc(var(--tui-space) * 9);
  --tui-list-radius: calc(var(--tui-radius) * 3);
  --tui-list-item-radius: calc(var(--tui-radius) * 2);
  --tui-list-shadow: 0 0 0 1px color-mix(in srgb, var(--tui-fg) 5%, transparent), 0 2px 6px rgb(0 0 0 / 0.04), 0 16px 40px rgb(0 0 0 / 0.1);
  --tui-list-font-size: var(--tui-text);
  --tui-list-title-size: calc(var(--tui-text) - 2px);
  --tui-list-bg: light-dark(var(--tui-bg), color-mix(in oklab, var(--tui-bg) 90%, var(--tui-fg)));
  --tui-list-fg: var(--tui-fg);
  --tui-list-muted: var(--tui-muted-fg);
  --tui-list-title: var(--tui-muted-fg);
  --tui-list-icon-bg: color-mix(in srgb, light-dark(var(--tui-bg), color-mix(in oklab, var(--tui-bg) 90%, var(--tui-fg))) 94%, var(--tui-fg));
  --tui-list-icon-fg: var(--tui-fg);
  --tui-list-chevron: color-mix(in srgb, var(--tui-muted-fg) 60%, transparent);
  --tui-list-item-bg-hover: color-mix(in srgb, light-dark(var(--tui-bg), color-mix(in oklab, var(--tui-bg) 90%, var(--tui-fg))) 95%, var(--tui-fg));
  --tui-list-ring: var(--tui-ring);
  --tui-list-ring-width: 2px;
}

.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;
}