Files
textual/docs/widgets/digits.md
Will McGugan 49281b3f27 Digits (#3073)
* Digits

* digits widget

* update requires str

* digits docs

* simplify

* tweak docs

* snapshot test

* change name

* simplify

* docs

* Update _digits.py superfluous import

* Update _digits.py docstring

* address review

* formatting

* Update tests/snapshot_tests/snapshot_apps/digits.py

Co-authored-by: Dave Pearson <davep@davep.org>

---------

Co-authored-by: Dave Pearson <davep@davep.org>
2023-08-09 10:25:17 +01:00

1.2 KiB
Raw Blame History

Digits

!!! tip "Added in version 0.33.0"

A widget to display numerical values in tall multi-line characters.

The digits 0-9 are supported, in addition to the following characters +, -, ^, :, and ×. Other characters will be displayed in a regular size font.

You can set the text to be displayed in the constructor, or call [update()][textual.widgets.Digits.update] to change the text after the widget has been mounted.

!!! note "This widget will respect the text-align rule."

  • Focusable
  • Container

Example

The following example displays a few digits of Pi:

=== "Output"

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

=== "digits.py"

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

Here's another example which uses Digits to display the current time:

=== "Output"

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

=== "clock.py"

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

Reactive attributes

This widget has no reactive attributes.

Bindings

This widget has no bindings.

Component classes

This widget has no component classes.


::: textual.widgets.Digits options: heading_level: 2