Skip to main content

Icon Picker

shadow

Icon picker allows the user to find and select an icon from a set of available icons. It includes text search for easier icon retrieval.

Basic usage

When to use

Use wje-icon-picker to improve readability, scannability, and contextual understanding of content.

When not to use

Do not replace structured interactive data with media-only presentation when precision is needed.

Accessibility

Provide alt text, maintain readable contrast, and include text equivalents for icon-only controls.

Best Practices

  • Compress media and use lazy loading in larger collections.
  • Keep information priority consistent across cards/lists.
  • Avoid duplicating the same meaning in icon and text without added value.

Attributes and Properties

icon

DescriptionThe selected icon's name.
Attributeicon
Typestring
Default-

size

DescriptionThe number of icons displayed per page in infinite scroll. Default is 60.
Attributesize
Typenumber
Default-

Events

NameDescription
wje-icon-picker:selectEmitted when an item is selected.

Methods

initial

DescriptionInitializes the component.
Signature() => void

getTags

DescriptionGets the tags.
Signature() => Promise<Array>

clearIconsContainer

DescriptionClears the icons container.
Signature() => void

debounce

DescriptionCreates a debounced version of the provided function that delays its execution until after the specified delay has passed since the last time it was invoked.
Signature(fn: Function, delay: number) => Function

CSS Shadow Parts

NameDescription
nativeThe native part of the component.
anchorThe part representing the anchor button displaying the selected icon.
pickerThe picker part containing the search and icon selection interface.
inputThe input part for searching icons.

CSS Custom Properties

NameDescription
--wje-color-picker-valueThe default color value.
--wje-color-picker-areaThe background color of the color picker area.
--wje-color-picker-swatchThe background color of the swatch picker.
--wje-color-picker-sizeThe size of the icons in the picker.
--wje-color-picker-radiusThe border radius of the picker.

Slots

No slots available for this component.