Save 15% on all Justd Blocks
Components

List Box

ListBox are designed to present and manage lists of options or data entries, allowing users to view and select from multiple choices efficiently.

Basic

ListBoxes can be enhanced with features such as multi-selection, filtering, and dynamic data updates. They are commonly used in applications to display and manage lists of options or data entries.

Nirvana
Radiohead
Foo Fighters
Arctic Monkeys
The Strokes

Installation

If you hit any issues, make sure you check out the installation guide here for more information.

Composed Components

When you install this component via the CLI, it automatically loads all composed components, so you don’t need to add them individually.

The List Box comes packed with several components to enhance functionality and provide a seamless experience.

A pop-up menu that reveals a list of selectable options, commonly used for navigation, filters, or form inputs.

Manual Installation

Make sure you also install the composed components and the required packages for the component to function properly.

Anatomy

Multiple Selection

To enable multiple selections, set the selectionMode prop to multiple. This prop has no default value, so it must be explicitly defined.

Apple
Banana
Orange
Strawberry
Grapes
Mango
Pineapple
Selected: 3

Item Details

You can enhance list items by providing additional details using the ListBoxItemDetails component.

AdminHas full access to all resources
EditorCan edit content but has limited access to settings
ViewerCan view content but cannot make changes
ContributorCan contribute content for review
GuestLimited access, mostly for viewing purposes

Section

Group items in a ListBox using sections for better organization.

Abbey Road
Sgt. Pepper's Lonely Hearts Club Band
Revolver
Led Zeppelin IV
Physical Graffiti
Houses of the Holy
Led Zeppelin II
The Dark Side of the Moon
The Wall
Wish You Were Here
Animals
Meddle
A Night at the Opera
News of the World
Sheer Heart Attack
The Game
Jazz
Queen II
Let It Bleed
Sticky Fingers
Exile on Main St.
Beggars Banquet
Some Girls
Tattoo You
Nevermind
In Utero
Bleach
The Doors
L.A. Woman
Strange Days
Morrison Hotel
OK Computer
Kid A
The Bends
In Rainbows
Back in Black
Highway to Hell
Let There Be Rock
Who's Next
Tommy
Quadrophenia
My Generation
The Who Sell Out

Rearrange

Enable drag-and-drop functionality in the ListBox by using the dragAndDropHooks prop with the useDragAndDrop hook. This allows users to rearrange items, insert new entries, or manage data across the list.

Nirvana
Radiohead
Foo Fighters
Arctic Monkeys
The Strokes

Controlled

To enable controlled mode, set the selectionMode prop to single. This allows you to manage the ListBox selection using the selectedKey prop.

Apple
Banana
Orange
Strawberry
Grapes
Mango
Pineapple
Selected: 1

Disabled

Disable specific ListBox items to restrict user interaction.

Apple
Banana
Orange
Strawberry
Grapes
Mango
Pineapple

You can also disable an item directly by passing the isDisabled prop to ListBoxItem.

<ListBoxItem isDisabled>Disabled</ListBoxItem>