Data List

A list of labels and values, such as the details of an order.

New users
312
Orders
1,480
Revenue
£9,860

Usage

Code
import { DataList } from '@leverui/components';
Code
<DataList.Root>
  <For each={data}>
    {(item) => (
      <DataList.Item>
        <DataList.ItemLabel>{item.label}</DataList.ItemLabel>
        <DataList.ItemValue>{item.value}</DataList.ItemValue>
      </DataList.Item>
    )}
  </For>
</DataList.Root>

Examples

Sizes

Use the size prop to change the size of the datalist component.

Name
Theo Park
Name
Theo Park
Name
Theo Park

Variants

Use the variant prop to change the variant of the datalist component.

New users
312
Orders
1,480
Revenue
£9,860
New users
312
Orders
1,480
Revenue
£9,860

Orientation

Use the orientation prop to change the orientation of the datalist component.

New users
312
Orders
1,480
Revenue
£9,860
New users
312
Orders
1,480
Revenue
£9,860

Info Tip

Render an info tip within DataList.Item to provide additional context to the datalist.

New users
312
Orders
1,480
Revenue
£9,860

Separator

Add a class on the DataList.Root to draw a separator between items.

First name
Imani
Last name
Kerr
Email
imani.kerr@example.com
Phone
555 0142
Address
42 Harbor Road, Lakeview

Closed Component

Wrap the parts in your own component so each item takes a few props. Uses InfoTip.

Code
import { Show, omit } from 'solid-js';
import type { JSX } from '@solidjs/web';
import { DataList, InfoTip } from '@leverui/components';

export const DataListRoot = DataList.Root;

export interface ClosedDataListItemProps {
  label: JSX.Element;
  value: JSX.Element;
  info?: JSX.Element | undefined;
  grow?: boolean | undefined;
  children?: JSX.Element | undefined;
  class?: string | undefined;
  style?: JSX.CSSProperties | undefined;
}

export function DataListItem(props: ClosedDataListItemProps) {
  const rest = omit(props, 'label', 'value', 'info', 'grow', 'children');
  const flex = (): JSX.CSSProperties | undefined => (props.grow ? { flex: '1' } : undefined);

  return (
    <DataList.Item {...rest}>
      <DataList.ItemLabel style={flex()}>
        {props.label}
        <Show when={props.info}>
          <InfoTip>{props.info}</InfoTip>
        </Show>
      </DataList.ItemLabel>
      <DataList.ItemValue style={flex()}>{props.value}</DataList.ItemValue>
      {props.children}
    </DataList.Item>
  );
}
Code
<DataListRoot orientation="horizontal">
  <DataListItem label="Status" value="Active" info="Updated hourly" />
</DataListRoot>

Guides

Semantics

Root renders a dl. Each Item is a div holding a dt label and a dd value. No interactive role, no keyboard behavior. If you change the elements with as or asChild, keep the meaning of dl, dt, and dd.

Shared defaults

DataList.PropsProvider sets reactive default size, orientation, and variant for the lists inside it. A prop on a root wins. Responsive values work, such as orientation={{ base: 'vertical', md: 'horizontal' }}.

Props

Root

PropDefaultTypeDescription
orientation'vertical''horizontal' | 'vertical'Label above its value or beside it.
size'md''sm' | 'md' | 'lg'List size.
variant'subtle''subtle' | 'bold'List style.
asdlNative tag nameHTML tag to render.
asChild—Solid render functionRender your own element.
unstyled—booleanTurn off the Lever UI styles.

Customize with CSS

Import @leverui/components/styles.css once.

Classes: .leverui-data-list__root, .leverui-data-list__item, .leverui-data-list__itemLabel, .leverui-data-list__itemValue.

Root attributes: data-size, data-orientation, data-variant, plus one per breakpoint you set, such as data-orientation-md. Unlayered CSS can target these and use semantic variables such as --leverui-colors-fg-muted.

A line between items:

Code
.my-data-list > .leverui-data-list__item + .leverui-data-list__item {
  border-top: 1px solid var(--leverui-colors-border);
}

Explorer

Click a part name to highlight it in the preview.

Component Anatomy

Hover to highlight, click to select parts