Universelle PySide6 UI/UX-Architektur-Fertigkeit
Entwerfen und erstellen Sie saubere, reaktionsfähige, menschzentrierte Desktop-Oberflächen in PySide6 für jede Anwendungsdomäne. Überprüfen Sie immer zuerst das vorhandene Theme, die Widgets und Konventionen des Zielprojekts – integrieren Sie sich natürlich, anstatt vorhandene Abstraktionen zu überschreiben. Laden Sie nur die spezifischen Referenzdateien, die für die aktuelle Aufgabe benötigt werden.
1. Progressive Offenlegungs-Routing (Bei Bedarf lesen)
- Theming, QSS-Stylesheets, Hell/Dunkel-Modus, HiDPI oder Layout-Primitive → Lesen Sie
./references/design-system-and-qss.md - Hauptfenster-Architektur, Seitenleisten, Tabs, Docks, Splitter oder Dashboards → Lesen Sie
./references/navigation-and-shell.md - Datentabellen, Listen, Bäume, Suchleisten, Filter oder leere/Ladezustände → Lesen Sie
./references/data-tables-and-filters.md - Modale Dialoge (
QDialog), Formulare, Detail-Drawer, Validierung oder Toast/Fortschritts-Feedback → Lesen Sie./references/forms-dialogs-and-feedback.md - Tastaturkürzel, Barrierefreiheit, i18n/RTL-Layouts oder Hintergrund-Threading → Lesen Sie
./references/accessibility-i18n-and-async.md - Aufsetzen einer brandneuen PySide6-App ohne vorhandenes Theme → Optional referenzieren Sie
./assets/base-theme.qss
2. Universelle UX-Gesetze (Angewandt auf Desktop-UI)
- Jakobs Gesetz: Passen Sie sich an etablierte Desktop-Konventionen an (
Strg+Sspeichern,Strg+Fsuchen,Escabbrechen/löschen,F5aktualisieren, standardmäßige Menü-/Symbolleisten-Platzierung), damit sich Benutzer sofort sicher fühlen. - Fitts' Gesetz: Halten Sie primäre Aktionen groß genug (
>= 36pxHöhe,>= 42pxfür Touch-/häufige Workflows) und verankern Sie sie dort, wo die Aufmerksamkeit des Benutzers bereits ist; vermeiden Sie lange Mauswege für wiederholte Aktionen. - Hicks Gesetz & Progressive Offenlegung: Begrenzen Sie die sichtbaren Optionen zu jedem Zeitpunkt. Gruppieren Sie sekundäre Optionen in Drawern, Tabs oder Overflow-Menüs, anstatt jedes Steuerelement auf einen Bildschirm zu drängen.
- Millers Gesetz & Gestalt-Nähe: Fassen Sie zusammengehörige Steuerelemente in sauberen visuellen Gruppen (
CardFrame) mit konsistenten Abständen (8pxinnerhalb einer Gruppe,16px–24pxzwischen Gruppen), damit Benutzer die Struktur mühelos erfassen können. - Doherty-Schwelle (
< 400msWahrgenommene Reaktionszeit): Blockieren Sie niemals die Qt-Ereignisschleife. Führen Sie E/A, Netzwerk und schwere Berechnungen in einem separaten Thread (QThreadPool/QRunnable) aus und zeigen Sie sofort Lade- oder Fortschrittsfeedback an. - Fehlervermeidung & Sichere Wiederherstellung: Validieren Sie inline vor dem Absenden, deaktivieren Sie unmögliche Aktionen mit klaren Tooltips, die erklären warum, und verlangen Sie explizite Bestätigung nur für destruktive oder irreversible Operationen.
3. Standard-Designsystem-Tokens (Anpassbar)
Wenn das Projekt bereits eine Palette, Typografie oder ein Abstandssystem definiert, folgen Sie den Projekt-Tokens. Andernfalls verwenden Sie diese sauberen, kontrastreichen Standardeinstellungen:
- Akzent & Fokus:
- Primäre Akzentfarbe:
#0F766E(Hover:#0D5F59, Gedrückt:#0A4A45, Weicher Farbton:#CCFBF1/#F0FDFA) – oder an den Markenfarbton der App anpassen. - Fokusring:
2px solidprimäre Akzentfarbe auf allen interaktiven Eingaben und Schaltflächen.
- Primäre Akzentfarbe:
- Neutrale Oberflächenhierarchie (Hell / Dunkel):
- App-Leinwand:
#F8FAFC(Hell) /#0F172A(Dunkel) - Erhöhte Oberfläche / Karte:
#FFFFFF(Hell) /#1E293B(Dunkel) - Subtile sekundäre Oberfläche (Kopfzeilen, Fußzeilen, Zebra):
#F1F5F9(Hell) /#334155(Dunkel) - Haarfeine Grenzlinie / Trennlinie:
#E2E8F0(Hell) /#334155(Dunkel) - Standard-Eingaberahmen:
#CBD5E1(Hell) /#475569(Dunkel)
- App-Leinwand:
- Typografie & Texthierarchie:
- Primärtext:
#0F172A(Hell) /#F8FAFC(Dunkel) - Sekundärer / Beschriftungstext:
#475569(Hell) /#CBD5E1(Dunkel) - Gedämpfter / Deaktivierter Text:
#94A3B8(Hell) /#64748B(Dunkel) - Schriftfamilie:
"Segoe UI", "Inter", "Cairo", system-ui, sans-serif(unterstützt Latein, Arabisch und mehrsprachige UIs sauber). - Schriftgrößenskala: Seitentitel
20pxFett, Abschnittstitel15pxHalbfett, Fließtext/Zelle13pxRegular, Beschriftung/Unterschrift12pxMittel, Hero-Metrik22px–26pxFett.
- Primärtext:
- Semantische Status-Tokens:
- Erfolg: Text
#15803D, Füllung#DCFCE7(Dunkel:#4ADE80/#14532D) - Warnung: Text
#B45309, Füllung#FEF3C7(Dunkel:#FBBF24/#451A03) - Gefahr: Text
#B91C1C, Füllung#FEE2E2(Dunkel:#F87171/#450A0A) - Info: Text
#0369A1, Füllung#E0F2FE(Dunkel:#38BDF8/#0C4A6E)
- Erfolg: Text
- Abstände & Geometrie:
- Abstandsskala:
4px(eng),8px(zusammengehörige Elemente),12px(Symbolleisten-/Formularabstand),16px(Kartenabstand),20px–24px(Seitenränder). - Steuerelementhöhen: Standard-Eingaben/Schaltflächen
36px, Häufige/Touch-Steuerelemente42px+, Tabellenkopf38px, Tabellenzeile>= 42px. - Rahmenradien: Steuerelemente
6px, Karten/Panels10px, Modale12px, Status-Pills11px.
- Abstandsskala:
4. Nicht verhandelbare PySide6-Engineering-Regeln
- Zuerst an vorhandenen Code anpassen: Verwenden Sie vorhandene Themenkonstanten, Basis-Widgets und Hilfsfunktionen wieder, bevor Sie neue Abstraktionen einführen.
- Saubere räumliche Gruppierung: Verwenden Sie
QFrame-Karten (1pxhaarfeine Grenzlinie, subtiler Oberflächenkontrast) oderQSplitter-Bereiche anstelle von schweren verschachteltenQGroupBox-Rahmen. - Model/View für tabellarische & Baumdaten: Verwenden Sie
QTableView/QTreeViewmitQAbstractItemModel(QAbstractTableModel),QSortFilterProxyModelundQStyledItemDelegate. Vermeiden Sie das Befüllen vonQTableWidget-Zellen mit schweren verschachtelten Widgets. - Semantisches QSS anstelle von Inline-Spaghetti: Stylen Sie über
setObjectName(...)-Rollen (PrimaryButton,DangerButton,Card,PageTitle) und dynamische Eigenschaften ([invalid="true"]mitunpolish()/polish()) anstatt rohesetStyleSheet(...)-Strings zu verstreuen. - Reaktionsfähige Layouts (Keine festen Containergrößen): Verwenden Sie niemals
setFixedSize()auf Fenstern, Karten oder Tabellen. Verlassen Sie sich auf Layouts, Dehnungsfaktoren,QSizePolicyundQScrollArea, damit UIs sauber über verschiedene Auflösungen, HiDPI-Displays und übersetzte Textlängen skalieren. - Deaktivierte Zustände erklären & Inline validieren: Jeder
setEnabled(False)-Aufruf MUSSsetToolTip(...)enthalten, der erklärt, warum das Element deaktiviert ist. Validieren Sie Eingaben inline mit hilfreichen Fehlerbeschriftungen – unterbrechen Sie niemals die Eingabe mitQMessageBox. - Ein kanonischer Ort pro Aktion: Duplizieren Sie niemals dieselbe Aktion sowohl in einer oberen Leiste als auch in einer unteren Fußzeile. Platzieren Sie primäre Seiten-CTAs oben rechts in
PageHeaderund primäre Formular-/Dialog-CTAs unten rechts in der modalen Fußzeile. - Tastatur-zuerst & Nicht blockierendes Feedback: Setzen Sie den anfänglichen Fokus in
showEvent(), verbinden SiesetTabOrder(), unterstützen SieEingabe/Escund verwenden Sie nicht blockierende Overlay-Toasts oder Statusleisten für Routinebestätigungen – reservieren Sie modale Dialoge für destruktive Bestätigungen. - Zurückhaltende, inhaltsangepasste Status-Badges: Dehnen Sie Tabellenstatus-Pills niemals auf eine einheitliche feste Breite oder überfluten Sie jede gesunde Zeile mit schweren, gesättigten Badges. Passen Sie die Pill-Breite dynamisch an
QFontMetrics.horizontalAdvance(text) + paddingan, halten Sie routinemäßige gesunde Zustände visuell ruhig (z. B. subtiler7px-Statuspunkt + klarer Text), damit Warnungen/Fehler sofort auffallen, und bewahren Sie die Zeilenauswahl sowie untere haarfeine Trennlinien innerhalb benutzerdefinierterQStyledItemDelegate.paint()-Überschreibungen.
5. Qualitätskontrolle vor dem Abschluss
Bevor Sie eine PySide6-UI-Implementierung finalisieren, überprüfen Sie:
- Hat jede Ansicht eine klare visuelle Hierarchie (
PageHeaderoder strukturierte Arbeitsbereichsleiste) mit keinen verwaisten schwebenden Steuerelementen? - Haben alle interaktiven Steuerelemente einheitliche Höhen (
>= 36px), klare Hover-/Fokus-Zustände und ausreichenden Farbkontrast? - Sind numerische/tabellarische Spalten rechtsbündig und entsprechend dem Gebietsschema der App formatiert?
- Sind Tabellenstatus-Badges an ihren Text angepasst, visuell ruhig auf gesunden Zeilen und nahtlos mit Zeilenauswahl und Trennlinien ausgerichtet?
- Verwenden leere, null-Treffer und Ladezustände einen dedizierten
QStackedWidget-Zustand anstelle von leerem Leerraum? - Erklärt sich jedes deaktivierte Steuerelement über
setToolTip()? - Werden langlaufende Aufgaben vom UI-Thread ausgelagert, sodass das Fenster niemals einfriert?