Skip to main content

ListItem

Overview​

The ListItem component renders a styled list item (<li>) element with Bulma helper class integration. Use it inside UnorderedList or OrderedList components to create list items with consistent styling.

info

The ListItem component is a thin wrapper around the HTML <li> element, providing consistent Bulma styling and helper class support.

Import​

import { ListItem, UnorderedList, OrderedList } from '@allxsmith/bestax-bulma';

Props​

PropTypeDefaultDescription
valuenumber—Custom value for ordered list items.
classNamestring—Additional CSS classes.
textColor'primary' | 'link' | 'info' | 'success' | 'warning' | 'danger' | 'black' | 'black-bis' | 'black-ter' | 'grey-darker' | 'grey-dark' | 'grey' | 'grey-light' | 'grey-lighter' | 'white' | 'light' | 'dark' | 'inherit' | 'current'—Text color helper.
bgColor'primary' | 'link' | 'info' | 'success' | 'warning' | 'danger' | 'black' | 'black-bis' | 'black-ter' | 'grey-darker' | 'grey-dark' | 'grey' | 'grey-light' | 'grey-lighter' | 'white' | 'light' | 'dark' | 'inherit' | 'current'—Background color helper.
childrenReact.ReactNode—Content to render inside the list item.
...All standard <li> and Bulma helper props(See Helper Props)

Usage​

Wrap Lists in Content for Traditional Styling

Without a Content wrapper, Bulma renders lists without the traditional margin, padding, and list-style markers (bullets, numbers). Wrap your lists in <Content> to get the expected typographic list appearance.

Default List Item​

The default usage of the ListItem component inside a list.

<Content>
  <UnorderedList>
    <ListItem>Default List Item</ListItem>
    <ListItem>Another item</ListItem>
  </UnorderedList>
</Content>

Colored List Item​

Apply text color to individual list items.

<Content>
  <UnorderedList>
    <ListItem textColor="primary">Primary item</ListItem>
    <ListItem textColor="success">Success item</ListItem>
    <ListItem textColor="warning">Warning item</ListItem>
    <ListItem textColor="danger">Danger item</ListItem>
  </UnorderedList>
</Content>

Custom Value in Ordered List​

Use the value prop to set a custom number in an ordered list.

<Content>
  <OrderedList>
    <ListItem>First item</ListItem>
    <ListItem value={10}>Tenth item (custom value)</ListItem>
    <ListItem>Eleventh item</ListItem>
  </OrderedList>
</Content>

All Colors​

Display list items in all Bulma theme colors.

<Content>
  <UnorderedList>
    <ListItem textColor="primary">Primary</ListItem>
    <ListItem textColor="link">Link</ListItem>
    <ListItem textColor="info">Info</ListItem>
    <ListItem textColor="success">Success</ListItem>
    <ListItem textColor="warning">Warning</ListItem>
    <ListItem textColor="danger">Danger</ListItem>
  </UnorderedList>
</Content>

Spaced List Items​

Use margin helpers for custom spacing between items.

<Content>
  <UnorderedList>
    <ListItem mb="3">Item with extra bottom margin</ListItem>
    <ListItem mb="3">Another spaced item</ListItem>
    <ListItem>Last item</ListItem>
  </UnorderedList>
</Content>

In Ordered List​

ListItem works the same way in ordered lists.

<Content>
  <OrderedList>
    <ListItem>First item</ListItem>
    <ListItem textColor="success">Second item (success)</ListItem>
    <ListItem>Third item</ListItem>
  </OrderedList>
</Content>

Accessibility​

  • Semantic Markup: Using proper <li> elements inside <ul> or <ol> ensures correct accessibility semantics.
  • Color Contrast: When using colored text or backgrounds, ensure sufficient contrast for readability.
  • Screen Readers: List items are announced as part of the list structure by screen readers.
info

Always use ListItem inside UnorderedList or OrderedList for proper semantic structure.

  • UnorderedList: Parent component for bulleted lists.
  • OrderedList: Parent component for numbered lists.
  • Content: For rich typographic content including lists.
  • Helper Props: Bulma helper props for spacing, color, etc.

Additional Resources​