File: rule.md

package info (click to toggle)
textual 2.1.2-1
  • links: PTS, VCS
  • area: main
  • in suites: forky, sid, trixie
  • size: 55,056 kB
  • sloc: python: 85,423; lisp: 1,669; makefile: 101
file content (83 lines) | stat: -rw-r--r-- 1,642 bytes parent folder | download
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
# 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

| Name          | Type              | Default        | Description                  |
| ------------- | ----------------- | -------------- | ---------------------------- |
| `orientation` | `RuleOrientation` | `"horizontal"` | The orientation of the rule. |
| `line_style`  | `LineStyle`       | `"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