Skip to content
Open
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
10 changes: 10 additions & 0 deletions articles/components/list-box/index.adoc
Original file line number Diff line number Diff line change
Expand Up @@ -211,6 +211,9 @@ List Box isn't designed to be used as an input field in forms, and lacks feature
See related components later for better options for use in forms.
List Box is best suited for use as a lightweight, scrollable, single-column list for single or multi-selection of items.

The List Box API supports using a [classname]`DataProvider` as its data source. However, List Box does not support lazy loading: all items are fetched from the data provider at once. For large data sets, consider using Virtual List or Grid for displaying items, or Combo Box or Multi-Select Combo Box when selection is required.


== Related Components

|===
Expand All @@ -222,6 +225,9 @@ List Box is best suited for use as a lightweight, scrollable, single-column list
|<<../combo-box#,Combo Box>>
|Select a value from a filterable overlay. Appropriate for large sets of options. Supports lazy loading and entry of custom values.

|<<../multi-select-combo-box#,Multi-Select Combo Box>>
| Select multiple values from a filterable overlay. Appropriate for large sets of options and supports lazy loading.

|<<../radio-button#,Radio Button Group>>
|Select a single option from a list. Optimal accessibility, as all options are visible without any user action.

Expand All @@ -230,6 +236,10 @@ List Box is best suited for use as a lightweight, scrollable, single-column list

|<<../grid#,Grid>>
|A more advanced list component for cases where multiple columns, filtering or lazy loading is required.

|<<../virtual-list#,Virtual List>>
| Display a large, scrollable list of items with lazy loading and custom item rendering.

|===


Expand Down
Loading