Skip to content

Digits

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() to change the text after the widget has been mounted.

This widget will respect the text-align rule.

  • Focusable
  • Container

Example

The following example displays a few digits of Pi:

DigitApp ══════════════════════════════════════════════ ╺━┓  ┓ ╻ ╻ ┓  ┏━╸┏━┓╺━┓ ┏━╸┏━╸╺━┓ ┏━╸┏━┓┏━┓╺━┓  ━┫  ┃ ┗━┫ ┃  ┗━┓┗━┫┏━┛ ┣━┓┗━┓ ━┫ ┗━┓┣━┫┗━┫  ┃ ╺━┛.╺┻╸  ╹╺┻╸,╺━┛╺━┛┗━╸,┗━┛╺━┛╺━┛,╺━┛┗━┛╺━┛  ╹ ══════════════════════════════════════════════

from textual.app import App, ComposeResult
from textual.widgets import Digits


class DigitApp(App):
    CSS = """
    Screen {
        align: center middle;
    }
    #pi {
        border: double green;
        width: auto;
    }
    """

    def compose(self) -> ComposeResult:
        yield Digits("3.141,592,653,5897", id="pi")


if __name__ == "__main__":
    app = DigitApp()
    app.run()

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

ClockApp  ┓ ┏━┓    ┓ ╻ ╻   ┏━┓┏━┓  ┃ ┃ ┃ :  ┃ ┗━┫ : ┃ ┃┃ ┃ ╺┻╸┗━┛   ╺┻╸  ╹   ┗━┛┗━┛

from datetime import datetime

from textual.app import App, ComposeResult
from textual.widgets import Digits


class ClockApp(App):
    CSS = """
    Screen {
        align: center middle;
    }
    #clock {
        width: auto;
    }
    """

    def compose(self) -> ComposeResult:
        yield Digits("", id="clock")

    def on_ready(self) -> None:
        self.update_clock()
        self.set_interval(1, self.update_clock)

    def update_clock(self) -> None:
        clock = datetime.now().time()
        self.query_one(Digits).update(f"{clock:%T}")


if __name__ == "__main__":
    app = ClockApp()
    app.run(inline=True)

Reactive Attributes

This widget has no reactive attributes.

Messages

This widget posts no messages.

Bindings

This widget has no bindings.

Component Classes

This widget has no component classes.


textual.widgets.Digits class

def __init__(
    self,
    value="",
    *,
    name=None,
    id=None,
    classes=None,
    disabled=False
):

Bases: Widget

A widget to display numerical values using a 3x3 grid of unicode characters.

name: The name of the widget.
id: The ID of the widget in the DOM.
classes: The CSS classes of the widget.
disabled: Whether the widget is disabled or not.

value property

value: str

The current value displayed in the Digits.

update method

def update(self, value):

Update the Digits with a new value.

Parameters
Parameter Default Description
value
str
required

New value to display.

Raises
Type Description
ValueError

If the value isn't a str.