Dropdown

Selection list component for autocomplete menus

Quick Start

main.py

from connectonion.tui import Dropdown, DropdownItem

# Create items
items = [
    DropdownItem(display="/today", value="/today", description="Daily briefing"),
    DropdownItem(display="/inbox", value="/inbox", description="Show emails"),
]

# Create dropdown
dropdown = Dropdown(items, max_visible=5, style="modern")

DropdownItem

Structured item with rich metadata:

Simple Item

main.py

from connectonion.tui import DropdownItem

# Simple item
item = DropdownItem(display="/today", value="/today")

With Description

main.py

item = DropdownItem(
    display="/today",
    value="/today",
    description="Daily email briefing",
    icon="📅"
)

Contact Style

main.py

item = DropdownItem(
    display="Davis Baer",
    value="davis@oneupapp.io",
    description="davis@oneupapp.io",
    subtitle="OneUp · founder",
    icon="👤"
)

API

DropdownItem

main.py

DropdownItem(
    display: str,          # Main text to show
    value: Any,            # Value returned when selected
    score: int = 0,        # Match score for sorting
    positions: list = [],  # Matched char positions (for highlighting)
    description: str = "", # Secondary text
    subtitle: str = "",    # Third line
    icon: str = "",        # Left icon (emoji)
    style: str = "",       # Rich style
)

Dropdown

main.py

Dropdown(
    items: list[DropdownItem],
    max_visible: int = 8,
    selected: int = 0,
    style: str = "modern",
)

File Icons

Built-in icons for common file types:

Icon	Type
📁	folder
📄	file (default)
🐍	.py
📜	.js, .ts
⚙️	.json, .yaml

Input

StatusBar