Back to Textual

Rule

docs/widgets/rule.md

8.2.51.6 KB
Original Source

Rule

A rule widget to separate content, similar to a <hr> HTML tag.

  • Focusable
  • Container

Examples

Horizontal Rule

The default orientation of a rule is horizontal.

The example below shows horizontal rules with all the available line styles.

=== "Output"

```{.textual path="docs/examples/widgets/horizontal_rules.py"}
```

=== "horizontal_rules.py"

```python
--8<-- "docs/examples/widgets/horizontal_rules.py"
```

=== "horizontal_rules.tcss"

```css
--8<-- "docs/examples/widgets/horizontal_rules.tcss"
```

Vertical Rule

The example below shows vertical rules with all the available line styles.

=== "Output"

```{.textual path="docs/examples/widgets/vertical_rules.py"}
```

=== "vertical_rules.py"

```python
--8<-- "docs/examples/widgets/vertical_rules.py"
```

=== "vertical_rules.tcss"

```css
--8<-- "docs/examples/widgets/vertical_rules.tcss"
```

Reactive Attributes

NameTypeDefaultDescription
orientationRuleOrientation"horizontal"The orientation of the rule.
line_styleLineStyle"solid"The line style of the rule.

Messages

This widget sends no messages.

Bindings

This widget has no bindings.

Component Classes

This widget has no component classes.


::: textual.widgets.Rule options: heading_level: 2

::: textual.widgets.rule options: show_root_heading: true show_root_toc_entry: true