Files
textual/docs/widgets/radiobutton.md
Dave Pearson 307b1789a1 Give radio button its own example code now
Still within a RadioSet, but this time only the code that uses RadioSet; not
the code that just uses strings.
2023-02-23 16:00:14 +00:00

63 lines
1.3 KiB
Markdown

# RadioButton
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 directly 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)