ListBox
A listbox displays a list of options and allows a user to select one or more of them.
Usage#
Demo#
import { ListBox, ListBoxItem } from "pigment-ui"; function ListBoxDemo() { return ( <ListBox aria-label="Favorite animal" selectionMode="single" className="w-64"> <ListBoxItem>Aardvark</ListBoxItem> <ListBoxItem>Cat</ListBoxItem> <ListBoxItem>Dog</ListBoxItem> <ListBoxItem>Kangaroo</ListBoxItem> <ListBoxItem>Panda</ListBoxItem> <ListBoxItem>Snake</ListBoxItem> </ListBox> ); }
Color#
import { ListBox, ListBoxItem } from "pigment-ui"; function ListBoxColor() { return ( <div className="grid grid-cols-2 max-sm:grid-cols-1 gap-4"> <ListBox color="default" aria-label="Favorite animal" selectionMode="single" className="w-64"> <ListBoxItem>Aardvark</ListBoxItem> <ListBoxItem>Cat</ListBoxItem> <ListBoxItem>Dog</ListBoxItem> <ListBoxItem>Kangaroo</ListBoxItem> <ListBoxItem>Panda</ListBoxItem> <ListBoxItem>Snake</ListBoxItem> </ListBox> <ListBox color="primary" aria-label="Favorite animal" selectionMode="single" className="w-64"> <ListBoxItem>Aardvark</ListBoxItem> <ListBoxItem>Cat</ListBoxItem> <ListBoxItem>Dog</ListBoxItem> <ListBoxItem>Kangaroo</ListBoxItem> <ListBoxItem>Panda</ListBoxItem> <ListBoxItem>Snake</ListBoxItem> </ListBox> <ListBox color="info" aria-label="Favorite animal" selectionMode="single" className="w-64"> <ListBoxItem>Aardvark</ListBoxItem> <ListBoxItem>Cat</ListBoxItem> <ListBoxItem>Dog</ListBoxItem> <ListBoxItem>Kangaroo</ListBoxItem> <ListBoxItem>Panda</ListBoxItem> <ListBoxItem>Snake</ListBoxItem> </ListBox> <ListBox color="success" aria-label="Favorite animal" selectionMode="single" className="w-64"> <ListBoxItem>Aardvark</ListBoxItem> <ListBoxItem>Cat</ListBoxItem> <ListBoxItem>Dog</ListBoxItem> <ListBoxItem>Kangaroo</ListBoxItem> <ListBoxItem>Panda</ListBoxItem> <ListBoxItem>Snake</ListBoxItem> </ListBox> <ListBox color="warning" aria-label="Favorite animal" selectionMode="single" className="w-64"> <ListBoxItem>Aardvark</ListBoxItem> <ListBoxItem>Cat</ListBoxItem> <ListBoxItem>Dog</ListBoxItem> <ListBoxItem>Kangaroo</ListBoxItem> <ListBoxItem>Panda</ListBoxItem> <ListBoxItem>Snake</ListBoxItem> </ListBox> <ListBox color="error" aria-label="Favorite animal" selectionMode="single" className="w-64"> <ListBoxItem>Aardvark</ListBoxItem> <ListBoxItem>Cat</ListBoxItem> <ListBoxItem>Dog</ListBoxItem> <ListBoxItem>Kangaroo</ListBoxItem> <ListBoxItem>Panda</ListBoxItem> <ListBoxItem>Snake</ListBoxItem> </ListBox> </div> ); }
Color individual#
import { ListBox, ListBoxItem } from "pigment-ui"; function ListBoxColorIndividual() { return ( <ListBox color="info" aria-label="Favorite animal" selectionMode="single" className="w-64"> <ListBoxItem>Aardvark</ListBoxItem> <ListBoxItem>Cat</ListBoxItem> <ListBoxItem>Dog</ListBoxItem> <ListBoxItem>Kangaroo</ListBoxItem> <ListBoxItem>Panda</ListBoxItem> <ListBoxItem color="success">Snake</ListBoxItem> </ListBox> ); }
Size#
import { ListBox, ListBoxItem } from "pigment-ui"; function ListBoxSize() { return ( <div className="flex flex-col gap-4"> <ListBox size="sm" aria-label="Favorite animal" selectionMode="single" className="w-64"> <ListBoxItem>Aardvark</ListBoxItem> <ListBoxItem>Cat</ListBoxItem> <ListBoxItem>Dog</ListBoxItem> <ListBoxItem>Kangaroo</ListBoxItem> <ListBoxItem>Panda</ListBoxItem> <ListBoxItem>Snake</ListBoxItem> </ListBox> <ListBox size="md" aria-label="Favorite animal" selectionMode="single" className="w-64"> <ListBoxItem>Aardvark</ListBoxItem> <ListBoxItem>Cat</ListBoxItem> <ListBoxItem>Dog</ListBoxItem> <ListBoxItem>Kangaroo</ListBoxItem> <ListBoxItem>Panda</ListBoxItem> <ListBoxItem>Snake</ListBoxItem> </ListBox> <ListBox size="lg" aria-label="Favorite animal" selectionMode="single" className="w-64"> <ListBoxItem>Aardvark</ListBoxItem> <ListBoxItem>Cat</ListBoxItem> <ListBoxItem>Dog</ListBoxItem> <ListBoxItem>Kangaroo</ListBoxItem> <ListBoxItem>Panda</ListBoxItem> <ListBoxItem>Snake</ListBoxItem> </ListBox> </div> ); }
Content#
import { ListBox, ListBoxItem } from "pigment-ui"; import { CatIcon, DogIcon } from "lucide-react"; function ListBoxContent() { return ( <ListBox aria-label="Favorite animal" selectionMode="single" className="w-64"> <ListBoxItem>Aardvark</ListBoxItem> <ListBoxItem startContent={<CatIcon />}>Cat</ListBoxItem> <ListBoxItem endContent={<DogIcon />}>Dog</ListBoxItem> <ListBoxItem>Kangaroo</ListBoxItem> <ListBoxItem>Panda</ListBoxItem> <ListBoxItem>Snake</ListBoxItem> </ListBox> ); }
Disabled#
import { ListBoxItem, ListBox } from "pigment-ui"; function ListBoxDisabled() { return ( <ListBox disabledKeys={["Dog"]} aria-label="Favorite animal" selectionMode="single" className="w-64"> <ListBoxItem>Aardvark</ListBoxItem> <ListBoxItem>Cat</ListBoxItem> <ListBoxItem>Dog</ListBoxItem> <ListBoxItem>Kangaroo</ListBoxItem> <ListBoxItem>Panda</ListBoxItem> <ListBoxItem>Snake</ListBoxItem> </ListBox> ); }
As card#