Basalt2/docs/references/elements/List.md

List : VisualElement

This is the list class. It provides a scrollable list of selectable items with support for custom item rendering, separators, and selection handling.

Properties

Property	Type	Default	Description
items	table	{}	List of items to display. Items can be tables with properties including selected state
selectable	boolean	true	Whether items in the list can be selected
multiSelection	boolean	false	Whether multiple items can be selected at once
offset	number	0	Current scroll offset for viewing long lists
selectedBackground	color	blue	Background color for selected items
selectedForeground	color	white	Text color for selected items

Events

Event	Parameters	Description
onSelect	index number, item any	Fired when an item is selected

Functions

Method	Returns	Description
List:addItem	List	Adds an item to the list
List:clear	List	Clears all items from the list
List:getSelectedItems	table	Gets the currently selected items
List:onSelect	List	Registers a callback for the select event
List:removeItem	List	Removes an item from the list
List:scrollToBottom	List	Scrolls the list to the bottom
List:scrollToTop	List	Scrolls the list to the top

Protected Functions

Method	Returns	Description
List:init	List	Initializes the List instance
List:mouse_click	boolean	Handles mouse click events
List:mouse_scroll	boolean	Handles mouse scroll events
List:render	-	Renders the list

List:addItem(text)

Adds an item to the list

Parameters

• text string|table The item to add (string or item table)

Returns

• List self The List instance

Usage

list:addItem("New Item")
list:addItem({text="Item", callback=function() end})

List:clear()

Clears all items from the list

Returns

• List self The List instance

Usage

list:clear()

List:getSelectedItems()

Gets the currently selected items

Returns

• table selected List of selected items

Usage

local selected = list:getSelectedItems()

List:onSelect(callback)

Registers a callback for the select event

Parameters

• callback function The callback function to register

Returns

• List self The List instance

Usage

list:onSelect(function(index, item) print("Selected item:", index, item) end)

List:removeItem(index)

Removes an item from the list

Parameters

• index number The index of the item to remove

Returns

• List self The List instance

Usage

list:removeItem(1)

List:scrollToBottom()

Scrolls the list to the bottom

Returns

• List self The List instance

List:scrollToTop()

Scrolls the list to the top

Returns

• List self The List instance