Basis / Tool
KatanA UI Core
Eine von einem bestimmten UI-Framework unabhängige Rust-UI-Basis mit Verträgen für Komponentenstatus, Ereignisse, Themes und Rendering sowie auswählbaren Integrationsschichten.
Rust-Entwickler, die wiederverwendbare UI-Komponenten und Anzeigegrundlagen bauen
01
Implementierte Fähigkeiten
02
Erste Schritte
- Bereiten Sie Rust und just vor und holen Sie das Repository.
- Testen Sie Komponenten mit just storybook und aktivieren Sie für die Integration nur die benötigten Features.
Bereiten Sie Rust und die erforderlichen Entwicklungstools vor und prüfen Sie vor der Installation die Umgebungsanforderungen im verknüpften README. Beispiele zeigen einen Einstieg und garantieren keinen Betrieb in jeder Umgebung.
Belegegit clone https://github.com/HiroyukiFuruno/katana-ui-core.git
cd katana-ui-core
just storybook01 / KUC
Anwendungsfälle
Montieren Sie den Bildschirm mit neutralen UI-Teilen
KUC ist kein fertiger App-Bildschirm, sondern eine Rust-Grundlage zum Kombinieren von Atomen, Molekülen, Layouts, Zuständen, Ereignissen und Rendermodellen. Der Host wählt SplitPane, Toolbar usw. aus und ist für die spezifische Bildschirmkonfiguration und Framework-Verbindungen verantwortlich.
Aktivieren Sie nur die erforderlichen Zeichnungsebenen
Der Standard ist ein framework-neutral core; egui, text-raster, svg-raster und raster-host können als Features ergänzt werden. So lassen sich UI input, Text-/SVG-raster und UI-tree rendering passend zur Host-Konfiguration auswählen, während der gemeinsame Vertrag erhalten bleibt.
02 / KUC
Ablauf von Eingabe zu Ausgabe
Geben Sie Teile und Einstellungen ein
Der Host generiert ein SplitPane und legt die Achse, ratio_percent, min/max_percent, handle_width_px, resize_mode und untergeordnete Knoten fest. Einstellungswerte können als Builder verkettet werden, und für jedes Teil werden auch Status-IDs verwaltet.
Umwandlung von Vorgängen in Verträge
Wenden Sie Pointer- oder Keyboard-Resize, Verhältnisänderung, Reset und Clamp als UiAction an. SplitPane korrigiert das Verhältnis innerhalb des Bereichs und wandelt das Operationsergebnis in callback log und interaction state um.
An Rendermodell übergeben
Das Teil wird in einen UiNode konvertiert und wird zu einem render model mit axis, ratio, handle, resize mode und shared state. Mit dem neuesten HEAD kann es an Canvas, TextRenderer und UI-tree renderer des raster-host angeschlossen werden; windowing und shell der Anwendung bleiben Host-Verantwortung.
03 / KUC
Wichtige APIs und CLI
SplitPaneAxis — Teilungsrichtung- Stellt Horizontal und Vertical dar und bestimmt die Teilungsrichtung. Dies ist nicht nur eine Anzeigebeschriftung, sondern ein Layoutvertrag, der in die axis des render model konvertiert wird.
SplitPaneResizeMode — Eingabemodi- Stellt PointerOnly, KeyboardOnly, PointerAndKeyboard, Disabled dar. Deaktiviert macht das Handle nicht fokussierbar und ermöglicht Ihnen, den Host-Eingabepfad explizit einzuschränken.
Verhältnis- und Clamp-Einstellungen- ratio_percent ist das aktuelle Verhältnis, min_percent und max_percent sind die zulässigen Bereiche und reset_percent ist der Rückgabewert. Der Eingabewert wird auf den festgelegten Bereich beschränkt und Anforderungen außerhalb des Bereichs werden nicht unverändert gerendert.
Öffentlicher raster-host-Vertrag- Das raster-host-Feature veröffentlicht Canvas, TextRenderer, UiTreeCanvasRenderer und UiTreeInteractionSurface. Damit lassen sich rendering und hit/interaction zusammenführen; core-Nutzer ohne dieses Feature erhalten keine zusätzlichen Abhängigkeiten.
04 / KUC
An einem Beispiel verstehen
Integrieren Sie den SplitPane-Betriebsvertrag
Erstellen Sie ein SplitPane horizontal bei 50 %, klemmen Sie es auf 20–80 %, ändern Sie es mit UiAction auf 64 % und wenden Sie dann die Größenänderung und das Zurücksetzen der Tastatur an. Da wir öffentliche Crate-Aktionstypen verwenden, können Hosts UI-Framework-Ereignisse in UiActions konvertieren und das resultierende Rückrufprotokoll in ihre eigene Statusverwaltung integrieren.
use katana_ui_core::component::ComponentAction;
use katana_ui_core::interaction::UiAction;
use katana_ui_core::layout::{SplitPane, SplitPaneAxis, SplitPaneResizeSource, SplitPaneResizeMode};
fn main() {
let mut split = SplitPane::new()
.axis(SplitPaneAxis::Horizontal)
.ratio_percent(50)
.min_percent(20)
.max_percent(80)
.resize_mode(SplitPaneResizeMode::PointerAndKeyboard);
let target = split.state_id().clone();
let _ = split.apply_action(&UiAction::split_pane_set_ratio(target.clone(), 64));
let _ = split.apply_action(&UiAction::split_pane_resize_by(
target.clone(),
4,
SplitPaneResizeSource::Keyboard,
));
let _ = split.apply_action(&UiAction::split_pane_reset_ratio(target));
println!("ratio={}", split.ratio_percent_value());
}05 / KUC
Integration und Grenzen
Bereiten Sie den Rust-Arbeitsbereich und die Funktionen vor
Fügen Sie katana-ui-core zu den Abhängigkeiten hinzu und beginnen Sie für die framework-neutrale Nutzung mit den Standard-Features. Aktivieren Sie Cargo-Features nur, wenn Sie egui oder raster-host benötigen, und übernehmen Sie die feature-spezifischen Abhängigkeiten in Ihre App.
Der Host ist für Shell und Validierung verantwortlich
Es handelt sich nicht um eine vollständige App, die AppShell und Seitenvorlagen enthält. Auch wenn Sie die EGU- oder Raster-Host-Verbindungsschicht verwenden, werden die anwendungsspezifische Bildschirmkonfiguration und die Fensterverwaltung auf der Hostseite zusammengestellt. Storybook ist eine Testumgebung für die Entwicklung. Überprüfen Sie daher bitte die Eingabe, das Layout und die Zeichnung auf dem tatsächlichen Host.
Belege
Diese Übersicht basiert auf den öffentlichen Repositories zum Zeitpunkt der Prüfung. Implementierung und Nutzung können in den verknüpften fixierten Commits geprüft werden.