Components/Form
Interactive docs page: https://wix-pages.com/design-system-documentation/#/component/listitemselecticon
<ListItemSelectIcon/> is an icon-only selectable list item designed for use in icon pickers, formatting toolbars, and dropdown menus where visual options can be represented by icons alone.
<Dropdown/> with listItemSelectIconBuilder for consistent option rendering.<Tooltip/> when the icon's meaning isn't immediately obvious, so users can hover to learn what each option represents.<ListItemSelect/> instead.<ListItemSelectIcon/> and <ListItemSelect/> in the same list. They have different visual footprints and serve different use cases.Indicate which item is chosed with selected prop.
Item size depends on the icon provided. If a small icon is used, the list item will automatically adjust its size to fit.
Component can be disabled, it automatically changes color of all areas if used as text or icon.
Pass custom content in the item depending on your use-case. You can construct any dropdown based selection list, from status selector with <Badges/> or color selector when needed.
| Name | Type | Default | Description |
|---|---|---|---|
dataHook | string | — | Applied as data-hook HTML attribute that can be used in the tests. |
disabled | boolean | — | If true, the item is disabled. |
highlighted | boolean | — | If true, the item is highlighted. |
icon (required) | ReactNode | — | Icon of the list item. |
label (required) | string | — | Label of the list item. |
onClick | MouseEventHandler | — | Callback function triggered when list item is clicked. |
selected | boolean | — | If true, the item is selected. |
showTooltip | boolean | — | If true, the tooltip is shown on hover. |
tooltipProps | Omit<TooltipProps, "children" | "disabled" | "content"> | — | Allows to pass all common tooltip props. |
Import the driver matching your test environment:
| Method | Description |
|---|---|
isSelected | — |
getAriaLabel | — |
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. |
Last updated: 22 October 2026