Skip to content

A simple drop-down (select) for textual with an optional search functionality

License

Notifications You must be signed in to change notification settings

mitosch/textual-select

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

33 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Textual: Select

IMPORTANT: Since version 0.24.0 Textual implemented a native dropdown. I strongly recommend to use the native version. This repository will slowly die. More information at the Blog Post about Select control.

A simple select widget (aka dropdown) for textual with an optional search field.

select_focus

select_open

select_search

Usage

from textual_select import Select

dropdown_data = [
    {"value": 0, "text": "Pick-Up"},
    {"value": 1, "text": "SUV"},
    {"value": 2, "text": "Hatchback"},
    {"value": 3, "text": "Crossover"},
    {"value": 4, "text": "Convertible"},
    {"value": 5, "text": "Sedan"},
    {"value": 6, "text": "Sports Car"},
    {"value": 7, "text": "Coupe"},
    {"value": 8, "text": "Minivan"}
]

Select(
    placeholder="please select",
    items=dropdown_data,
    list_mount="#main_container"
)

Installation

pip install textual-select

Requires textual 0.11.0 or later.

Limitations

This textual widget is in early stage and has some limitations:

  • It needs a specific mount point (list_mount) where the dropdown list shall appear. This is needed because the container widget with the select itself could be too small. Maybe in future versions this will no longer needed.
  • It can only open below, not above: Make sure to reserve space below the dropdown.
  • The dropdown list has a fixed height of 5 entries. This will be configurable in future versions.

Similar Widgets

About

A simple drop-down (select) for textual with an optional search functionality

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages