EEnterUI
DocsComponentsThemesDonation
Get Started
  • Component onboarding
    • Text
    • List
    • DescriptionList
    • Alert
    • Avatar
    • AvatarGroup
    • Separator
EnterUIDocsFoundationsContentList
FoundationsUpdated 6 May 2026

List

Semantic ordered and unordered lists with refined markers.

List keeps native list semantics while giving product surfaces consistent spacing, density, and marker tone.

#Default usage

Default list

The default renders a semantic unordered list.

  • Install package
  • Import CSS
  • Use components
Code
<List>
  <ListItem>Install package</ListItem>
  <ListItem>Import CSS</ListItem>
  <ListItem>Use components</ListItem>
</List>

#Import

Code
import { List, ListItem } from "@froggdesign/enter-ui-react";

#Variants

List variants

Ordered lists keep native numbering by default.

  • Theme variables are loaded first
  • EnterUI component CSS is loaded second
  1. Install packages
  2. Import styles
  3. Compose components

#Size

Sizes

Use small lists in dense sidebars and tables.

  • Small list item
  • Compact supporting detail
  • Default list item
  • Normal product copy
  • Large list item
  • Use for spacious overview pages

#Tone

Tones

Tone changes the marker, not the whole sentence.

  • Secondary implementation notes
  • Accessible by default
  • Review before publishing
  • Failed contract check
  • New package version available

#Patterns

Markers

Custom markers stay restrained and preserve list semantics.

  • Default marker
  • Themeable with CSS variables
  • Composes with className
  • Dot marker
  • Dash marker
  • No marker

#Accessibility

List renders native ul or ol elements, and ListItem renders li. Custom markers are visual pseudo-elements on list items, so screen readers still receive normal list semantics. Keep item text descriptive instead of relying only on marker shape or color.

#API

  • variant: unordered or ordered.
  • size: sm, md, or lg.
  • density: compact, normal, or spacious.
  • marker: default, check, dot, dash, or none.
  • tone: default, muted, success, warning, error, or info.
  • List extends native ul or ol props and supports className.
  • ListItem extends native li props and supports className.

#Styling

List uses .eui-list and .eui-list__item with data attributes for variant, size, density, marker, and tone. Custom marker styles are intentionally small and token-driven so lists stay readable in light and dark mode.

PreviousText
NextDescriptionList

On this page

  1. Default usage
  2. Import
  3. Variants
  4. Size
  5. Tone
  6. Patterns
  7. Accessibility
  8. API
  9. Styling