Začínáme s TUIX Core

Tento průvodce vás provede předpoklady, importem a základním workflow pro tvorbu terminálových UI s TUIX Core.

Předpoklady

Před začátkem se ujistěte, že máte nainstalovaný Python 3.8+. TUIX Core závisí na wcwidth pro přesné měření šířky Unicode znaků. Váš terminál musí podporovat ANSI escape sekvence a 24-bitové RGB barvy (většina moderních terminálů ano).

Import

from tuix.core import TuixEngine

engine = TuixEngine()

Vytvoření instance TuixEngine inicializuje všech pět subsystémů: engine.styles (Styles), engine.components (ComponentAPI), engine.layout (LayoutEngine), engine.render (RenderEngine) a engine.input (InputHandler).

Základní workflow

1. Vytvořte TuixEngine — inicializuje všechny subsystémy
2. Vytvořte komponentu přes engine.components.create(type, id)
3. Nakonfigurujte vlastnosti přes engine.components.set_property()
4. Nastavte rozměry layoutu a režimy okrajů přes engine.layout
5. Volitelně upravte styly přes engine.styles
6. Zavolejte engine.render.draw() pro render a start input smyčky

Rychlý příklad

from tuix.core import TuixEngine

engine = TuixEngine()

# 1. Create a component
engine.components.create("choice", "main_menu")

# 2. Set properties
engine.components.set_property(
    id="main_menu", param="label", value="Select an option:"
)
engine.components.set_property(
    id="main_menu", param="choices",
    value=[[{"name": "Option 1", "action": None}]]
)

# 3. Render UI
engine.render.draw()
# Input is automatically handled in draw() for choice components

Co se děje při draw()

Když zavoláte engine.render.draw(), framework:

1. Vyčistí obrazovku terminálu
2. Vypočítá rozměry layoutu proporčně k velikosti terminálu
3. Vyrenderuje komponentu pomocí Unicode box-drawing okrajů a stylovaného textu
4. Vstoupí do input smyčky — šipky navigují menu, Enter potvrzuje výběr

Další kroky

Přejděte na instalační průvodce, nainstalujte TUIX Core a poté pokračujte tutoriálem First Component pro vytvoření plně interaktivního menu.