63 lines
1.1 KiB
Markdown
63 lines
1.1 KiB
Markdown
# 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 run
|
|
-- Create a checkbox for a setting
|
|
```
|
|
|
|
```lua run
|
|
local checkbox = parent:addCheckBox()
|
|
```
|
|
|
|
```lua run
|
|
:setText("Enable Feature")
|
|
```
|
|
|
|
```lua run
|
|
:setCheckedText("✓")
|
|
```
|
|
|
|
```lua run
|
|
:onChange("checked", function(self, checked)
|
|
```
|
|
|
|
```lua run
|
|
-- React to checkbox state changes
|
|
```
|
|
|
|
```lua run
|
|
if checked then
|
|
```
|
|
|
|
```lua run
|
|
-- Handle enabled state
|
|
```
|
|
|
|
```lua run
|
|
else
|
|
```
|
|
|
|
```lua run
|
|
-- Handle disabled state
|
|
```
|
|
|
|
```lua run
|
|
end
|
|
```
|
|
|
|
```lua run
|
|
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|
|