List

Semantic lists with tokenized markers, rhythm, and per-item icons.

  • Semantic tokens over raw colors
  • Responsive props on every primitive
  • Precompiled CSS — no build step

Import#

import { List } from "astralis-ui";
// List.Item is available on the component itself

Marker styles#

styleType covers bullets and numbering; pair the numbered ones with as="ol" so the semantics match the visuals.

disc
  • One
  • Two
  • Three
circle
  • One
  • Two
  • Three
square
  • One
  • Two
  • Three
decimal
  1. One
  2. Two
  3. Three
lower-alpha
  1. One
  2. Two
  3. Three
upper-roman
  1. One
  2. Two
  3. Three

Icon lists#

styleType="none" plus a per-item icon replaces markers entirely — the feature-list and changelog staple.

  • Layout category fully documented
  • Typography in progress
  • Overlay components waiting on rework
  • Time machine still not shipping

Props#

Both parts extend Box.

PropTypeDefaultDescription
styleType"disc" | "circle" | "square" | "decimal" | "lower-alpha" | "upper-roman" | "none""disc"Marker style; none removes marker and indent.
spacing"0" | "1" | "1.5" | "2" | "2.5" | "3" | "4" | "5" | "6" | "8""2"Vertical rhythm between items.
asElementType"ul"Use "ol" for numbered lists.

List.Item#

PropTypeDefaultDescription
iconReactNodeLeading icon; suppresses the native marker.
asElementType"li"Rendered element.