Communitygithub.com

PySide6 UI

Universelle PySide6/Qt für Python UI/UX-Architektur- und Designsystem-Fähigkeit für jede Desktop-Anwendung. Immer verwenden beim Entwerfen, Erstellen, Refaktorieren, Stylen oder Überprüfen von PySide6-Fenstern, Navigationsstrukturen, QSS-Themes, Dashboards, Datentabellen, Such-/Filterleisten, CRUD-Formularen, modalen Dialogen, asynchroner Reaktionsfähigkeit, RTL/i18n oder Tastatur-Workflows.

Was ist PySide6 UI?

Diese Fertigkeit bietet ein umfassendes, universelles UI/UX-Architektur- und Designsystem für PySide6 (Qt für Python) Desktop-Anwendungen. Sie ist besonders nützlich, weil sie einen konsistenten, menschzentrierten Ansatz für die Erstellung reaktionsfähiger und barrierefreier Oberflächen bietet, der auf etablierten UX-Gesetzen wie den Gesetzen von Jakob, Fitts, Hick und Miller basiert. Die Fertigkeit unterstützt alle Phasen der UI-Entwicklung – vom Entwurf über die Implementierung bis hin zur Überprüfung – und ist für jede Anwendungsdomäne geeignet. Sie enthält detaillierte Referenzen zu Themen, Navigation, Datentabellen, Formularen und Barrierefreiheit, die je nach Bedarf geladen werden können, sowie nicht verhandelbare technische Regeln für PySide6, wie die Verwendung von Model/View-Architekturen, semantischem QSS und die Vermeidung von blockierenden Operationen im UI-Thread. Darüber hinaus definiert sie ein anpassbares Designsystem mit Farbpaletten, Typografie, Abständen und semantischen Status-Tokens für eine konsistente visuelle Gestaltung über mehrere Anwendungen hinweg.

Funktioniert mit~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/MohammedBoure/skills/tree/main/pyside6-ui

In Ihrer bevorzugten KI fragen

Öffnet einen neuen Chat, in dem dieser Agent-Skill bereits geladen ist.

Dokumentation

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)

  1. Jakobs Gesetz: Passen Sie sich an etablierte Desktop-Konventionen an (Strg+S speichern, Strg+F suchen, Esc abbrechen/löschen, F5 aktualisieren, standardmäßige Menü-/Symbolleisten-Platzierung), damit sich Benutzer sofort sicher fühlen.
  2. Fitts' Gesetz: Halten Sie primäre Aktionen groß genug (>= 36px Höhe, >= 42px fü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.
  3. 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.
  4. Millers Gesetz & Gestalt-Nähe: Fassen Sie zusammengehörige Steuerelemente in sauberen visuellen Gruppen (CardFrame) mit konsistenten Abständen (8px innerhalb einer Gruppe, 16px–24px zwischen Gruppen), damit Benutzer die Struktur mühelos erfassen können.
  5. Doherty-Schwelle (< 400ms Wahrgenommene 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.
  6. 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 solid primäre Akzentfarbe auf allen interaktiven Eingaben und Schaltflächen.
  • 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)
  • 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 20px Fett, Abschnittstitel 15px Halbfett, Fließtext/Zelle 13px Regular, Beschriftung/Unterschrift 12px Mittel, Hero-Metrik 22px–26px Fett.
  • 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)
  • 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-Steuerelemente 42px+, Tabellenkopf 38px, Tabellenzeile >= 42px.
    • Rahmenradien: Steuerelemente 6px, Karten/Panels 10px, Modale 12px, Status-Pills 11px.

4. Nicht verhandelbare PySide6-Engineering-Regeln

  1. Zuerst an vorhandenen Code anpassen: Verwenden Sie vorhandene Themenkonstanten, Basis-Widgets und Hilfsfunktionen wieder, bevor Sie neue Abstraktionen einführen.
  2. Saubere räumliche Gruppierung: Verwenden Sie QFrame-Karten (1px haarfeine Grenzlinie, subtiler Oberflächenkontrast) oder QSplitter-Bereiche anstelle von schweren verschachtelten QGroupBox-Rahmen.
  3. Model/View für tabellarische & Baumdaten: Verwenden Sie QTableView / QTreeView mit QAbstractItemModel (QAbstractTableModel), QSortFilterProxyModel und QStyledItemDelegate. Vermeiden Sie das Befüllen von QTableWidget-Zellen mit schweren verschachtelten Widgets.
  4. Semantisches QSS anstelle von Inline-Spaghetti: Stylen Sie über setObjectName(...)-Rollen (PrimaryButton, DangerButton, Card, PageTitle) und dynamische Eigenschaften ([invalid="true"] mit unpolish()/polish()) anstatt rohe setStyleSheet(...)-Strings zu verstreuen.
  5. Reaktionsfähige Layouts (Keine festen Containergrößen): Verwenden Sie niemals setFixedSize() auf Fenstern, Karten oder Tabellen. Verlassen Sie sich auf Layouts, Dehnungsfaktoren, QSizePolicy und QScrollArea, damit UIs sauber über verschiedene Auflösungen, HiDPI-Displays und übersetzte Textlängen skalieren.
  6. Deaktivierte Zustände erklären & Inline validieren: Jeder setEnabled(False)-Aufruf MUSS setToolTip(...) enthalten, der erklärt, warum das Element deaktiviert ist. Validieren Sie Eingaben inline mit hilfreichen Fehlerbeschriftungen – unterbrechen Sie niemals die Eingabe mit QMessageBox.
  7. 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 PageHeader und primäre Formular-/Dialog-CTAs unten rechts in der modalen Fußzeile.
  8. Tastatur-zuerst & Nicht blockierendes Feedback: Setzen Sie den anfänglichen Fokus in showEvent(), verbinden Sie setTabOrder(), unterstützen Sie Eingabe/Esc und verwenden Sie nicht blockierende Overlay-Toasts oder Statusleisten für Routinebestätigungen – reservieren Sie modale Dialoge für destruktive Bestätigungen.
  9. 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) + padding an, halten Sie routinemäßige gesunde Zustände visuell ruhig (z. B. subtiler 7px-Statuspunkt + klarer Text), damit Warnungen/Fehler sofort auffallen, und bewahren Sie die Zeilenauswahl sowie untere haarfeine Trennlinien innerhalb benutzerdefinierter QStyledItemDelegate.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 (PageHeader oder 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?

Verwandte Skills