Files
textual/docs/widgets/radiobutton.md
Rodrigo Girão Serrão d787f61090 State version of widget addition in docs. (#2144)
* State version of widget addition in docs.

Related issues: #2133

* Fix ListX version info.

* Retroactively update changelog.
2023-03-27 22:32:18 +01:00

65 lines
1.4 KiB
Markdown

# RadioButton
!!! tip "Added in version 0.13.0"
A simple radio button which stores a boolean value.
- [x] Focusable
- [ ] Container
A radio button is best used with others inside a [`RadioSet`](./radioset.md).
## Example
The example below shows radio buttons, used within a [`RadioSet`](./radioset.md).
=== "Output"
```{.textual path="docs/examples/widgets/radio_button.py"}
```
=== "radio_button.py"
```python
--8<-- "docs/examples/widgets/radio_button.py"
```
=== "radio_button.css"
```sass
--8<-- "docs/examples/widgets/radio_button.css"
```
## Reactive Attributes
| Name | Type | Default | Description |
| ------- | ------ | ------- | ------------------------------ |
| `value` | `bool` | `False` | The value of the radio button. |
## Bindings
The radio button widget defines the following bindings:
::: textual.widgets._toggle_button.ToggleButton.BINDINGS
options:
show_root_heading: false
show_root_toc_entry: false
## Component Classes
The radio button 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.RadioButton.Changed
## See Also
- [RadioButton](../api/radiobutton.md) code reference
- [RadioSet](./radioset.md)