@spark-web/text-list

---

title: Text List storybookPath: data-display-textlist--default

List semantics are handled automatically, including the use of ordered lists where appropriate.

<Columns gap="large">
  <TextList>
    <Text>Bullet</Text>
    <Text>Bullet</Text>
    <Text>Bullet</Text>
  </TextList>
  <TextList type="number">
    <Text>Number</Text>
    <Text>Number</Text>
    <Text>Number</Text>
  </TextList>
  <TextList icon={<CheckCircleIcon size="xxsmall" />}>
    <Text>Icon</Text>
    <Text>Icon</Text>
    <Text>Icon</Text>
  </TextList>
</Columns>

Examples

Color, size and gap

Lists support the same sizes and colors as Text, and the same gap as Stack.

<Columns gap="large">
  <TextList tone="muted" size="large" gap="large">
    <Text>Large</Text>
    <Text>Large</Text>
    <Text>Large</Text>
  </TextList>
  <TextList tone="muted" size="standard" gap="medium">
    <Text>Standard</Text>
    <Text>Standard</Text>
    <Text>Standard</Text>
  </TextList>
  <TextList tone="muted" size="small" gap="small">
    <Text>Small</Text>
    <Text>Small</Text>
    <Text>Small</Text>
  </TextList>
</Columns>

Rich content

Use the Stack as a list item to display multiple lines of text.

<TextList gap="large">
  <Stack gap="medium">
    <Text weight="strong">This is a paragraph.</Text>
    <Text>This is another paragraph.</Text>
  </Stack>
  <Stack gap="medium">
    <Text weight="strong">This is a paragraph.</Text>
    <Text>This is another paragraph.</Text>
  </Stack>
</TextList>

Nested lists

Lists of varying types can be nested within each other.

<TextList gap="large" type="number">
  <Stack gap="medium">
    <Text>Number list</Text>
    <TextList>
      <Text>Bullet list</Text>
      <Text>Bullet list</Text>
      <Text>Bullet list</Text>
    </TextList>
  </Stack>
  <Stack gap="medium">
    <Text>Number list</Text>
    <TextList>
      <Text>Bullet list</Text>
      <Text>Bullet list</Text>
      <Text>Bullet list</Text>
    </TextList>
  </Stack>
</TextList>

Props

Prop	Type	Default	Description
children	React.ReactNode		The elements that represent each item in the list
data?	DataAttributeMap		Sets data attributes on the component.
gap?	StackProps['gap']	'large'	Sets the size of the gap between each item.
icon?	React.ReactElement<IconProps>		Provide an icon to be used as the "bullet" element.
size?	TextProps['size']		Sets the size of child text elements.
tone?	TextProps['tone']		Sets the tone of child text elements.
type?	'ul' | 'ol'	'ul'	Sets the list type. Equivalent to HTML's ordered and unordered lists.

The TextList component also passes extra props into the component's nested Stack component.