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:
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:
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.
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.