Files
textual/docs/widget_gallery.md
Will McGugan 7db7139bb8 Select widget (#2501)
* overlay rule

* select WIP

* select control, made binding description optional

* changelog

* style tweak

* Added constrain

* changelog

* test fix

* drop markup, tidy

* tidy

* select namespace

* tests

* docs

* Added changed event

* changelog

* expanded

* tests and snapshits

* examples and docs

* simplify

* update reactive attributes

* type fix

* docstrings

* allow renderables

* superfluous init

* typing fix

* optimization

* revert optimizations

* fixed words

* changelog

* docstrings

* don't need this

* changelog

* comment

* Update docs/widgets/select.md

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

* review changes

* review updates

---------

Co-authored-by: Dave Pearson <davep@davep.org>
2023-05-08 10:55:39 +01:00

5.4 KiB

hide
hide
navigation

Widgets

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

Button

A simple button with a variety of semantic styles.

Button reference{ .md-button .md-button--primary }

Checkbox

A classic checkbox control.

Checkbox reference{ .md-button .md-button--primary }

ContentSwitcher

A widget for containing and switching display between multiple child widgets.

ContentSwitcher reference{ .md-button .md-button--primary }

DataTable

A powerful data table, with configurable cursors.

DataTable reference{ .md-button .md-button--primary }

DirectoryTree

A tree view of files and folders.

DirectoryTree reference{ .md-button .md-button--primary }

A footer to display and interact with key bindings.

Footer reference{ .md-button .md-button--primary }

Header

A header to display the app's title and subtitle.

Header reference{ .md-button .md-button--primary }

Input

A control to enter text.

Input reference{ .md-button .md-button--primary }

Label

A simple text label.

Label reference{ .md-button .md-button--primary }

ListView

Display a list of items (items may be other widgets).

ListView reference{ .md-button .md-button--primary }

LoadingIndicator

Display an animation while data is loading.

LoadingIndicator reference{ .md-button .md-button--primary }

MarkdownViewer

Display and interact with a Markdown document (adds a table of contents and browser-like navigation to Markdown).

MarkdownViewer reference{ .md-button .md-button--primary }

Markdown

Display a markdown document.

Markdown reference{ .md-button .md-button--primary }

OptionList

Display a vertical list of options (options may be Rich renderables).

OptionList reference{ .md-button .md-button--primary }

Placeholder

Display placeholder content while you are designing a UI.

Placeholder reference{ .md-button .md-button--primary }

ProgressBar

A configurable progress bar with ETA and percentage complete.

ProgressBar reference{ .md-button .md-button--primary }

RadioButton

A simple radio button.

RadioButton reference{ .md-button .md-button--primary }

RadioSet

A collection of radio buttons, that enforces uniqueness.

RadioSet reference{ .md-button .md-button--primary }

Select

Select from a number of possible options.

Select reference{ .md-button .md-button--primary }

Static

Displays simple static content. Typically used as a base class.

Static reference{ .md-button .md-button--primary }

Switch

A on / off control, inspired by toggle buttons.

Switch reference{ .md-button .md-button--primary }

Tabs

A row of tabs you can select with the mouse or navigate with keys.

Tabs reference{ .md-button .md-button--primary }

TabbedContent

A Combination of Tabs and ContentSwitcher to navigate static content.

TabbedContent reference{ .md-button .md-button--primary }

TextLog

Display and update text in a scrolling panel.

TextLog reference{ .md-button .md-button--primary }

Tree

A tree control with expandable nodes.

Tree reference{ .md-button .md-button--primary }