mirror of
https://github.com/Textualize/textual.git
synced 2025-10-17 02:38:12 +03:00
d787f61090
* State version of widget addition in docs. Related issues: #2133 * Fix ListX version info. * Retroactively update changelog.
62 lines
1.2 KiB
Markdown
62 lines
1.2 KiB
Markdown
# Checkbox
|
|
|
|
!!! tip "Added in version 0.13.0"
|
|
|
|
A simple checkbox widget which stores a boolean value.
|
|
|
|
- [x] Focusable
|
|
- [ ] Container
|
|
|
|
## Example
|
|
|
|
The example below shows check boxes in various states.
|
|
|
|
=== "Output"
|
|
|
|
```{.textual path="docs/examples/widgets/checkbox.py"}
|
|
```
|
|
|
|
=== "checkbox.py"
|
|
|
|
```python
|
|
--8<-- "docs/examples/widgets/checkbox.py"
|
|
```
|
|
|
|
=== "checkbox.css"
|
|
|
|
```sass
|
|
--8<-- "docs/examples/widgets/checkbox.css"
|
|
```
|
|
|
|
## Reactive Attributes
|
|
|
|
| Name | Type | Default | Description |
|
|
| ------- | ------ | ------- | -------------------------- |
|
|
| `value` | `bool` | `False` | The value of the checkbox. |
|
|
|
|
## Bindings
|
|
|
|
The checkbox widget defines the following bindings:
|
|
|
|
::: textual.widgets._toggle_button.ToggleButton.BINDINGS
|
|
options:
|
|
show_root_heading: false
|
|
show_root_toc_entry: false
|
|
|
|
## Component Classes
|
|
|
|
The checkbox widget provides the following component classes:
|
|
|
|
::: textual.widgets._toggle_button.ToggleButton.COMPONENT_CLASSES
|
|
options:
|
|
show_root_heading: false
|
|
show_root_toc_entry: false
|
|
|
|
## Messages
|
|
|
|
### ::: textual.widgets.Checkbox.Changed
|
|
|
|
## See Also
|
|
|
|
- [Checkbox](../api/checkbox.md) code reference
|