DOCS
v0.4

Components / Listbox

Listbox

Selectable option list with single/multi-select, keyboard navigation, type-ahead, and group headers.

formsv0.6.0

Playground

Examples

Check right (default)
<cg-listbox label="Choose framework" style="max-width:300px;"></cg-listbox>
Check left
<cg-listbox checkPosition="left" label="Choose size" style="max-width:300px;"></cg-listbox>
Multi-select
<cg-listbox multiple label="Select toppings" style="max-width:300px;"></cg-listbox>
With groups
<cg-listbox label="Choose item" style="max-width:300px;"></cg-listbox>

Import

import { CgListbox } from '@cognivo/components';
// Or tree-shake: import '@cognivo/components/cg-listbox';

Per-component imports ship only that component (~8 kB gzip).

API Reference

PropTypeDefaultDescription
optionsListboxOption[]Options — {value, label, description?, disabled?, group?}
valuestring | string[]""Selected value(s)
multiplebooleanfalseAllow multi-select
checkPosition"left" | "right""right"Checkmark position — left or right of the label
labelstringAccessible label

Events

EventDetailDescription
cg-change{value: string | string[]}When selection changes