ListItemSelectIcon

Components/Form

Interactive docs page: https://wix-pages.com/design-system-documentation/#/component/listitemselecticon

Overview

Copy

<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.

Do

  • Use it inside <Dropdown/> with listItemSelectIconBuilder for consistent option rendering.
  • Use it for options that are universally recognizable by icon alone, such as alignment, bold and italic, or shapes.
  • Provide a <Tooltip/> when the icon's meaning isn't immediately obvious, so users can hover to learn what each option represents.

Don't

  • Don't use it when the option needs a text label to be understood. Use <ListItemSelect/> instead.
  • Don't mix <ListItemSelectIcon/> and <ListItemSelect/> in the same list. They have different visual footprints and serve different use cases.
  • Don't pass interactive elements, such as buttons or links, as the icon prop. The entire component is already clickable.

Feature examples

Selected

Indicate which item is chosed with selected prop.

Copy

Size

Item size depends on the icon provided. If a small icon is used, the list item will automatically adjust its size to fit.

Copy

Disabled

Component can be disabled, it automatically changes color of all areas if used as text or icon.

Copy

Custom content

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.

Copy

Code

Copy

Props

NameTypeDefaultDescription
dataHookstring—Applied as data-hook HTML attribute that can be used in the tests.
disabledboolean—If true, the item is disabled.
highlightedboolean—If true, the item is highlighted.
icon (required)ReactNode—Icon of the list item.
label (required)string—Label of the list item.
onClickMouseEventHandler—Callback function triggered when list item is clicked.
selectedboolean—If true, the item is selected.
showTooltipboolean—If true, the tooltip is shown on hover.
tooltipPropsOmit<TooltipProps, "children" | "disabled" | "content">—Allows to pass all common tooltip props.

Testkit

Import the driver matching your test environment:

Copy

Driver methods

MethodDescription
isSelected—
getAriaLabel—
existsChecks whether the component found with the given data hook.
elementGets the component root element.
clickClicks on the component root element.
baseReturns UniDriver for the base element.

Changelog

  • 1.340.0 (2026-10-21) — maintenance release, no component-specific changes
  • 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.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.266.0 (2026-04-07) — maintenance release, no component-specific changes
  • 1.263.0 (2026-03-31) — feat: add border-radius token support (#16072) — has visual changes
  • 1.260.1 (2026-03-23) — 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.182.0 (2025-04-23) — fix: make content have full width (#14767)
  • 1.138.1 (2024-10-30) — maintenance release, no component-specific changes
  • 1.135.0 (2024-10-23) — feat: add ListItemSelectIcon component (#14221)

Last updated: 22 October 2026

Did this help?