BridgeBeta
  • Brand
  • Digital Assets
    Foundations
    Icons
    Components
    Templates
  • Resources
    Design Tokens
    How-tos
    Best Practices
    Libraries
    Accessibility
    Products List
  • Support
    • Overview
    • Actions
      • Overview
      • Button
      • ContextMenu
      • Link
    • Controls
      • Overview
      • Checkbox
      • Tag
      • Toggle
    • Forms
      • Overview
      • DatePicker
      • FileUploader
      • Input
      • NumberInput
      • RadioButton
      • Search
      • Select
      • Slider
      • TextArea
      • TextInput
    • Hooks
      • useIsomorphicLayoutEffect
      • useMediaQuery
      • useSettings
    • Navigation
      • Overview
      • AnchorNavigation
      • BannerNavigation
      • Breadcrumb
      • Footer
      • InfoBar
      • MainNavigation
      • SecondaryNavigation
      • StepNavigation
      • SubNavigation
    • Overlay
      • Overview
      • Credits
      • Modal
      • ModalWrapper
      • Notification
      • Tooltip
    • Structure
      • Overview
      • Accordion
      • AuthLayout
      • Avatar
      • Callout
      • Card
      • ContentSwitcher
      • Empty
      • Hero
      • InlineLoading
      • Item
      • List
      • Loading
      • mdxComponents
      • Module
      • Pagination
      • ReadMore
      • Story
      • Table
      • Tabs
      • Text
      • Unit
      • User
      • WFPCoreProvider
      • Wrapper
Components
Structure
List

List

  • Design
  • Code
  • Props

Import statement

import { List, ListItem } from "@wfp/react"

Common ListBaseProps for all kinds of lists:

PropertyTypeDefaultDescription
colonbooleanfalseIf true, colons will be displayed in the List items.
kindstring (see kinds below)nullSpecifies the visual presentation style of the List.
smallbooleanfalseIf true, renders the List with a smaller font size and padding.

Kinds of Lists

  • unstyled
  • simple-inline
  • simple
  • details
  • unordered
  • ordered
  • tooltip
  • bullets

Extended Props

Depending on the kind of list chosen, the component may also accept all standard attributes for either an <ul> or a <ol> tag.

Using Different Kinds

simple

Simple vertical list.

Editable Example

<List kind="simple">
  <ListItem>First Item</ListItem>
  <ListItem>Second Item</ListItem>
  {/* More ListItems ... */}
</List>;

simple Inline

Simple horizontal list.

Editable Example

<List kind="simple-inline">
  <ListItem>First Item</ListItem>
  <ListItem>Second Item</ListItem>
</List>;

bullets

Adds bullets in front of each list entry.

Editable Example

<List kind="bullets">
  <ListItem>First Item</ListItem>
  <ListItem>Second Item</ListItem>
</List>;

ordered

Creates an ordered list

Editable Example

<List kind="ordered">
  <li>First Item</li>
  <li>Second Item</li>
</List>;

details

Detail view here the content is on a new line and the title is bold.

Editable Example

<List kind="details">
  <ListItem>First Item</ListItem>
  <ListItem>Second Item</ListItem>
</List>;

Displaying Colons

Adding colons after each title

Editable Example

<List colon={true} kind="details">
  <ListItem title="First">Item with colon</ListItem>
  <ListItem title="Second">
    Another item with colon
  </ListItem>
</List>;

Using Small Styling

Uses a smaller font-size for the list.

Editable Example

<List small={true}>
  <ListItem>Small styled item</ListItem>
  <ListItem>Another small styled item</ListItem>
</List>;

On this page

  • Kinds of Lists
  • Extended Props
  • Using Different Kinds
  • simple
  • simple Inline
  • bullets
  • ordered
  • details
  • Displaying Colons
  • Using Small Styling

References

  • Storybook
Storybook
Figma library
Contact us
2025 © World Food Programme