textual-api-reference

Import widgets from textual.widgets, such as Button, Input, or DataTable, and compose them in your app's compose method. Each widget exposes reactive attributes that trigger re-renders on change and emits messages like Button.Pressed that you handle with on_ methods.

DataTable exposes show_header, fixed_rows, zebra_stripes, cursor_type, cursor_coordinate, and cell_padding among others. It also provides methods like add_column, add_row, update_cell, and sort, plus messages such as CellSelected and RowHighlighted.

No, show_clock does not exist on Header and is a common hallucination. The clock is always shown; control its format with the time_format attribute, and set tall after mount or via CSS since it cannot be passed to the constructor.

Input emits Changed, Submitted, and Blurred messages carrying the current value, while Select emits Changed with the selected value. Every message includes a .control attribute pointing to the posting widget, often with a widget-named alias like .button or .select.

Log appends plain-text lines only and does not support Rich markup, offering write_line and write_lines methods. RichLog accepts Rich renderables with optional markup, highlighting, and wrapping, making it suitable for formatted output like tables and syntax blocks.