ConnectOnionConnectOnion
DocsTUIDropdown

Dropdown

Selection list component for autocomplete menus

Quick Start

main.py
1from connectonion.tui import Dropdown, DropdownItem 2 3# Create items 4items = [ 5 DropdownItem(display="/today", value="/today", description="Daily briefing"), 6 DropdownItem(display="/inbox", value="/inbox", description="Show emails"), 7] 8 9# Create dropdown 10dropdown = Dropdown(items, max_visible=5, style="modern")

DropdownItem

Structured item with rich metadata:

Simple Item

main.py
1from connectonion.tui import DropdownItem 2 3# Simple item 4item = DropdownItem(display="/today", value="/today")

With Description

main.py
1item = DropdownItem( 2 display="/today", 3 value="/today", 4 description="Daily email briefing", 5 icon="๐Ÿ“…" 6)

Contact Style

main.py
1item = DropdownItem( 2 display="Davis Baer", 3 value="davis@oneupapp.io", 4 description="davis@oneupapp.io", 5 subtitle="OneUp ยท founder", 6 icon="๐Ÿ‘ค" 7)

API

DropdownItem

main.py
1DropdownItem( 2 display: str, # Main text to show 3 value: Any, # Value returned when selected 4 score: int = 0, # Match score for sorting 5 positions: list = [], # Matched char positions (for highlighting) 6 description: str = "", # Secondary text 7 subtitle: str = "", # Third line 8 icon: str = "", # Left icon (emoji) 9 style: str = "", # Rich style 10)

Dropdown

main.py
1Dropdown( 2 items: list[DropdownItem], 3 max_visible: int = 8, 4 selected: int = 0, 5 style: str = "modern", 6)

File Icons

Built-in icons for common file types:

IconType
๐Ÿ“folder
๐Ÿ“„file (default)
๐Ÿ.py
๐Ÿ“œ.js, .ts
โš™๏ธ.json, .yaml