Skip to main content

A select widget (aka dropdown) for Textual.

Project description

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

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

textual_select-0.3.4.tar.gz (6.2 kB view hashes)

Uploaded Source

Built Distribution

textual_select-0.3.4-py3-none-any.whl (6.9 kB view hashes)

Uploaded Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page