CheckBox
A toggleable UI element that can be checked or unchecked. Displays different text based on its state and supports automatic sizing. Commonly used in forms and settings interfaces for boolean options.
Extends: VisualElement
Usage
lua
-- Create a checkbox for a setting
local checkbox = parent:addCheckBox()
:setText("Enable Feature")
:setCheckedText("✓")
:onChange("checked", function(self, checked)
-- React to checkbox state changes
if checked then
-- Handle enabled state
else
-- Handle disabled state
end
end)Properties
| Property | Type | Default | Description |
|---|---|---|---|
| checked | boolean | false | The current state of the checkbox (true=checked, false=unchecked) |
| text | string | empty | Text shown when the checkbox is unchecked |
| checkedText | string | x | Text shown when the checkbox is checked |
| autoSize | boolean | true | Automatically adjusts width based on text length |