Skip to content
Textual
OptionList
Initializing search
GitHub
Home
Introduction
Tutorial
Guide
Widgets
Reference
API
How To
FAQ
Roadmap
Blog
Textual
GitHub
Home
Introduction
Introduction
Getting started
Help
Tutorial
Guide
Guide
Devtools
App Basics
Styles
Textual CSS
DOM Queries
Layout
Events and Messages
Input
Actions
Reactivity
Themes
Widgets
Content
Animation
Screens
Workers
Command Palette
Testing
Widgets
Reference
Reference
CSS Types
CSS Types
<border>
<color>
<hatch>
<horizontal>
<integer>
<keyline>
<name>
<number>
<overflow>
<position>
<percentage>
<scalar>
<text-align>
<text-style>
<vertical>
Events
Events
AppBlur
AppFocus
Blur
Click
DescendantBlur
DescendantFocus
Enter
Focus
Hide
Key
Leave
Load
Mount
MouseCapture
MouseDown
MouseMove
MouseRelease
MouseScrollDown
MouseScrollUp
MouseUp
Paste
Print
Resize
ScreenResume
ScreenSuspend
Show
Unmount
Styles
Styles
Align
Background
Background-tint
Border
Border-subtitle-align
Border-subtitle-background
Border-subtitle-color
Border-subtitle-style
Border-title-align
Border-title-background
Border-title-color
Border-title-style
Box-sizing
Color
Content-align
Display
Dock
Grid
Grid
Column-span
Grid-columns
Grid-gutter
Grid-rows
Grid-size
Row-span
Hatch
Height
Keyline
Layer
Layers
Layout
Links
Links
Link-background
Link-background-hover
Link-color
Link-color-hover
Link-style
Link-style-hover
Margin
Max-height
Max-width
Min-height
Min-width
Offset
Opacity
Outline
Overflow
Padding
Position
Scrollbar colors
Scrollbar colors
Scrollbar-background
Scrollbar-background-active
Scrollbar-background-hover
Scrollbar-color
Scrollbar-color-active
Scrollbar-color-hover
Scrollbar-corner-color
Scrollbar-gutter
Scrollbar-size
Scrollbar-visibility
Text-align
Text-opacity
Text-overflow
Text-wrap
Text-style
Tint
Visibility
Width
Widgets
Widgets
Button
Checkbox
Collapsible
ContentSwitcher
DataTable
Digits
DirectoryTree
Footer
Header
Input
Label
Link
ListItem
ListView
LoadingIndicator
Log
MarkdownViewer
Markdown
MaskedInput
OptionList
OptionList
Table of contents
Examples
Options as simple strings
Options as Option instances
Options as Rich renderables
Reactive Attributes
Messages
Bindings
Component Classes
OptionList
*content
name
id
classes
disabled
markup
compact
BINDINGS
COMPONENT_CLASSES
compact
highlighted
highlighted_option
option_count
options
OptionHighlighted
OptionMessage
option_list
index
control
option
option_id
option_index
option_list
OptionSelected
action_cursor_down
action_cursor_up
action_first
action_last
action_page_down
action_page_up
action_select
add_option
option
add_options
new_options
clear_options
disable_option
option_id
disable_option_at_index
enable_option
option_id
enable_option_at_index
get_option
option_id
get_option_at_index
index
get_option_index
option_id
remove_option
option_id
remove_option_at_index
index
replace_option_prompt
option_id
prompt
replace_option_prompt_at_index
index
prompt
scroll_to_highlight
top
set_options
options
validate_highlighted
watch_highlighted
option_list
DuplicateID
Option
prompt
id
disabled
id
prompt
OptionDoesNotExist
Placeholder
Pretty
ProgressBar
RadioButton
RadioSet
RichLog
Rule
Select
SelectionList
Sparkline
Static
Switch
TabbedContent
Tabs
TextArea
Toast
Tree
API
API
textual.app
textual.await_complete
textual.await_remove
textual.binding
textual.cache
textual.color
textual.command
textual.constants
textual.containers
textual.compose
textual.content
textual.coordinate
textual.dom
textual.events
textual.errors
textual.filter
textual.fuzzy
textual.geometry
textual.getters
textual.highlight
textual.layout
textual.lazy
textual
textual.logging
textual.map_geometry
textual.markup
textual.message_pump
textual.message
textual.on
textual.pilot
textual.css.query
textual.reactive
textual.renderables
textual.screen
textual.scrollbar
textual.scroll_view
textual.signal
textual.strip
textual.suggester
textual.system_commands
textual.timer
textual.types
textual.validation
textual.walk
textual.widget
textual.work
textual.worker
textual.worker_manager
How To
How To
Center things
Design a Layout
Package a Textual app with Hatch
Render and compose
Style Inline Apps
Save time with Textual containers
FAQ
Roadmap
Blog
Blog
Archive
Archive
2025
2024
2023
2022
Categories
Categories
DevLog
News
Release
Table of contents
Examples
Options as simple strings
Options as Option instances
Options as Rich renderables
Reactive Attributes
Messages
Bindings
Component Classes
OptionList
*content
name
id
classes
disabled
markup
compact
BINDINGS
COMPONENT_CLASSES
compact
highlighted
highlighted_option
option_count
options
OptionHighlighted
OptionMessage
option_list
index
control
option
option_id
option_index
option_list
OptionSelected
action_cursor_down
action_cursor_up
action_first
action_last
action_page_down
action_page_up
action_select
add_option
option
add_options
new_options
clear_options
disable_option
option_id
disable_option_at_index
enable_option
option_id
enable_option_at_index
get_option
option_id
get_option_at_index
index
get_option_index
option_id
remove_option
option_id