This page ships a Markdown twin for AI tools.

ComponentsListItem

displaytexulinot agent-emittableapp

ListItem

list-item

A list row with a title, optional description, icon and trailing meta.

One token contract, every theme. Display components take color, radius, density and state styling from the --tx-* token contract — the same variables the theme strip below overrides — so a theme swap re-colors them without per-component fixes.

Live examples

Inbox row

Inbox row

Loading demo…

In your theme

This page renders in the site theme, enterprise-neutral. Every one of the 210 library themes re-colors every component through the --tx-* contract. The three below carry real token values from the library, rendered at build — no island, no extra requests.

  • Violet

    light mode · AA contrast

    • background
    • surface
    • primary
    • accent
    • border
    Open Theme Studio

  • Monochrome

    light mode · AA contrast

    • background
    • surface
    • primary
    • accent
    • border
    Open Theme Studio

  • Accessible Dark Contrast

    dark mode · AAA contrast

    • background
    • surface
    • primary
    • accent
    • border
    Open Theme Studio

Props

Public props for ListItem
NameKindRequiredDefaultDescription
titlestringno——
descriptionstringno——
metastringno——
iconstringno—Built-in or registered icon name
hrefstringno——
hrefTrustenum (developer, untrusted)no"developer"—
currentbooleannofalse—
disabledbooleannofalse—
dividedbooleannofalseHairline under this row
classstringno——

Keyboard

Keyboard behavior for ListItem
KeyAction
A, aA listitem; with href it is a link, with onSelect a button. Trailing controls sit outside the main control.

Accessibility

  • A listitem; with href it is a link, with onSelect a button. Trailing controls sit outside the main control.

Evidence for list-item

Latest committed gates for list-item (as of 2026-10-23). Static snapshot — not live CI.

Behavior

n/ano behavior scenario

No dedicated behavior scenario for this catalog id (a styled or display surface, covered by its unit and axe tests).

Size (gzip)

texuli/list-item · budget 12.0 KiB

Budget from texuli.budgets.json; re-measure with `pnpm size --filter <entry>`.

Axe

documented

  • tests/e2e/site-component-pages.spec.ts
  • docs/quality (a11y-*)

Site component pages axe gate; package-level a11y docs under docs/quality when present.

Browsers

  • chromium
  • webkit
  • mobile

Playwright projects: Desktop Chrome, Desktop Safari, Pixel 7. Firefox is a known gap on this host.

When to use

Use when

  • A settings row, an inbox row, or a navigation list of links

Don’t use when

Prefer another component

  • A data table (use table)
  • A kanban card (use data-board)