Components/Form
Interactive docs page: https://wix-pages.com/design-system-documentation/#/component/listitemsection
List item section allows you to group or divide list options or actions.
- Use it to build Dropdown, Multiselect, Search dropbox values or custom lists.
- Don't use it as standalone component for general layouts. Use SectionHeader instead.
A list item section consists of title and suffix areas.
Component divides lists by 4 types:
title - acts as a title for list items.
subheader - acts as separator between list items for differentiation
whitespace - adds some padding between list items.
divider - same as whitespace, but with a line.
Add text, icons or a button at the end using suffix.
By default, text wraps into any number of lines. With ellipsis enabled, it will truncate to fit the width of the parent container.
Use it to group options into categories.
| Name | Type | Default | Description |
|---|
dataHook | string | — | Applied as data-hook HTML attribute that can be used in the tests. |
ellipsis | boolean | — | If true, long text doesn't break into more than one line and is terminated with an ellipsis. |
onClick | MouseEventHandler | — | A callback function called when suffix is clicked. |
suffix | ReactNode | — | Suffix node. Renders TextButton for a string otherwise the node itself. |
title | ReactNode | — | Text of the list item. |
type | "title" | "whitespace" | "divider" | "subheader" | — | A list item section can be * title - Acts as a title for following list items. * subheader - Acts as separator between list items for differentiation. * whitespace - Adds some padding between list items. * divider - Same as whitespace, but with a line. |
Import the driver matching your test environment:
| Method | Description |
|---|
getTitle | Get title Text |
getSuffix | Gets suffix |
exists | Checks whether the component found with the given data hook. |
element | Gets the component root element. |
click | Clicks on the component root element. |
base | Returns UniDriver for the base element. |
- 1.339.0 (2026-10-19) — maintenance release, no component-specific changes
- 1.338.0 (2026-10-15) — maintenance release, no component-specific changes
- 1.330.3 (2026-09-29) — maintenance release, no component-specific changes
- 1.330.0 (2026-09-28) — maintenance release, no component-specific changes
- 1.329.0 (2026-09-24) — maintenance release, no component-specific changes
- 1.328.0 (2026-09-22) — maintenance release, no component-specific changes
- 1.325.0 (2026-09-17) — maintenance release, no component-specific changes
- 1.310.0 (2026-08-10) — maintenance release, no component-specific changes
- 1.292.0 (2026-06-22) — maintenance release, no component-specific changes
- 1.291.0 (2026-06-19) — maintenance release, no component-specific changes
- 1.272.0 (2026-04-27) — maintenance release, no component-specific changes
- 1.266.0 (2026-04-07) — maintenance release, no component-specific changes
- 1.260.0 (2026-03-17) — maintenance release, no component-specific changes
- 1.247.2 (2026-01-21) — maintenance release, no component-specific changes
- 1.232.0 (2025-11-28) — maintenance release, no component-specific changes
- 1.216.0 (2025-09-01) — maintenance release, no component-specific changes
- 1.204.0 (2025-07-03) — maintenance release, no component-specific changes
- 1.172.0 (2025-03-20) — maintenance release, no component-specific changes
- 1.166.0 (2025-03-04) — breaking: list-item-section font size change in studio theme (#14558)
- 1.138.1 (2024-10-30) — maintenance release, no component-specific changes
- 1.124.0 (2024-09-06) — maintenance release, no component-specific changes
- 1.115.0 (2024-07-17) — maintenance release, no component-specific changes
- 1.103.4 (2024-05-02) — maintenance release, no component-specific changes
- 1.102.0 (2024-04-16) — maintenance release, no component-specific changes
- 1.94.0 (2024-02-14) — maintenance release, no component-specific changes
- 1.93.0 (2024-02-08) — maintenance release, no component-specific changes
- 1.92.1 (2024-02-05) — maintenance release, no component-specific changes