Welcome to the Textual widget gallery.
We have many more widgets planned, or you can build your own.
Info
Textual is a TUI framework. Everything below runs in the terminal.
A simple button with a variety of semantic styles.
Button reference
Checkbox
A classic checkbox control.
Checkbox reference
The original Footer widget.
Warning
This has been replaced by Footer, and will be removed in Textual v1.0
ClassicFooter reference
Collapsible
Content that may be toggled on and off by clicking a title.
Collapsible reference
ContentSwitcher
A widget for containing and switching display between multiple child
widgets.
ContentSwitcher reference
DataTable
A powerful data table, with configurable cursors.
DataTable reference
Digits
Display numbers in tall characters.
Digits reference
DirectoryTree
A tree view of files and folders.
DirectoryTree reference
A footer to display and interact with key bindings.
Footer reference
A header to display the app's title and subtitle.
Header reference
A control to enter text.
Input reference
Label
A simple text label.
Label reference
ListView
Display a list of items (items may be other widgets).
ListView reference
LoadingIndicator
Display an animation while data is loading.
LoadingIndicator reference
Log
Display and update lines of text (such as from a file).
Log reference
MarkdownViewer
Display and interact with a Markdown document (adds a table of contents and browser-like navigation to Markdown).
MarkdownViewer reference
Markdown
Display a markdown document.
Markdown reference
OptionList
Display a vertical list of options (options may be Rich renderables).
OptionList reference
Placeholder
Display placeholder content while you are designing a UI.
Placeholder reference
Pretty
Display a pretty-formatted Rich renderable.
Pretty reference
ProgressBar
A configurable progress bar with ETA and percentage complete.
ProgressBar reference
A simple radio button.
RadioButton reference
RadioSet
A collection of radio buttons, that enforces uniqueness.
RadioSet reference
RichLog
Display and update text in a scrolling panel.
RichLog reference
Rule
A rule widget to separate content, similar to a <hr> HTML tag.
Rule reference
Select
Select from a number of possible options.
Select reference
SelectionList
Select multiple values from a list of options.
SelectionList reference
Sparkline
Display numerical data.
Sparkline reference
Static
Displays simple static content. Typically used as a base class.
Static reference
Switch
An on / off control, inspired by toggle buttons.
Switch reference
Tabs
A row of tabs you can select with the mouse or navigate with keys.
Tabs reference
TabbedContent
A Combination of Tabs and ContentSwitcher to navigate static content.
TabbedContent reference
TextArea
A multi-line text area which supports syntax highlighting various languages.
TextArea reference
Tree
A tree control with expandable nodes.
Tree reference