Ein Pajamas-Leitfaden für technische Workflows: tatsächliche semantische Design-Token, fließende Typografie und Abstände, ein gestufter Pipeline-Inspektor, verständliche Fehlerausgaben und eine ausdrücklich lokale Wiederholungs-Simulation.
Vorschau der Benutzeroberfläche des GitLab Pajamas-Designsystems
Filtere Jobs nach Status, wähle einen Job aus, um seine Ausgabe zu lesen, simuliere einen erfolgreichen Linkcheck nach einem Fehler und setze die ursprünglichen Testdaten zurück.
Natives @gitlab/ui 138.0.0 CSS; ursprüngliche Stufenanordnung, HTML- und lokale Zustandslogik. Keine tatsächliche CI-Aktivität. · Implementierungsreferenz
02
Designreferenz für das GitLab Pajamas-Designsystem
Der veröffentlichte Light-Token-Export und das native CSS von @gitlab/ui 138.0.0. GL_*-Namen sind JavaScript-Exporte; ihre kleingeschriebenen --gl-*-Entsprechungen erscheinen im kompilierten CSS. Das Beispiel verwendet das native Stylesheet mit der ursprünglichen HTML- und Zustandslogik, nicht eingebundene Vue-Komponenten.
Informationsarchitektur der Pipeline im GitLab Pajamas-Designsystem
Fehlerkontext vor Wiederherstellungsoptionen anzeigen
Die Kopfzeile nennt eine fiktive Pipeline, einen Branch und einen Commit, damit der Job-Inspektor den nötigen Kontext bietet. Build, Test und Publish sind als Gruppen sichtbar, und für den ausgewählten Job wird die zugehörige Ausgabe angezeigt. Beim fehlgeschlagenen Linkcheck werden Route und Abbruchbedingung erläutert, bevor die Person die Wiederholungsaktion sieht.
Ein kompaktes Diagramm übersichtlich halten
Dieses Beispiel verwendet Spalten für Phasen und Schaltflächen, statt die Implementierung eines vollständigen Abhängigkeitsdiagramms vorzutäuschen. Auf schmalen Bildschirmen werden die Phasen in der Dokumentreihenfolge untereinander angeordnet. Eine Produktionspipeline benötigt möglicherweise parallele Jobs, Abhängigkeiten sowie wartende, manuelle und abgebrochene Status; diese sollten ausdrücklich modelliert und nicht aus den drei Beispielüberschriften abgeleitet werden.
Semantische Farben und Status im GitLab Pajamas-Designsystem
Semantische Rollen der Benutzeroberfläche für die Arbeitsfläche verwenden
Der Light-Export bietet warme neutrale Oberflächen, klar abgestufte Textkontraste und dezente Rahmen. Das Beispiel verwendet die Standardoberfläche für Jobkarten, eine blaue Auswahloberfläche und einen dunklen Protokollbereich. Der Leitfaden nennt die genauen Paketwerte, damit sich diese Beziehungen nachvollziehen lassen, ohne Farben aus einem Screenshot abzulesen.
Statusbezeichnungen aussagekräftig gestalten
In jeder Jobzeile und jedem Badge steht Passed oder Failed. Ein Häkchen oder Kreuz ergänzt den Text; farbige Badges allein wären nicht eindeutig. Markenlila wird nicht als allgemeines Erfolgssignal verwendet. Die Statusreferenzen in der Tabelle sind bewusst von der Auswahlfarbe Blau getrennt.
Typografische Skala und technische Texte im GitLab Pajamas-Designsystem
Fließende Ausdrücke beibehalten, wo sie vorgesehen sind
Das Paket stellt feste kleine Rollen und größere Rollen auf Basis von clamp bereit. Wird clamp durch seinen größten Endwert ersetzt, ändert sich das responsive Verhalten. Das ursprüngliche Beispiel verwendet einen 24px-Titel in Anwendungsgröße und kompakte unterstützende Rollen von 12–14px; diese Entscheidungen sind als Layoutvorgaben gekennzeichnet, nicht als zusätzliche Paket-Tokens.
Monospace für Kennungen und Ausgaben verwenden
Branch und Commit sind im Code-Stil gesetzt, während Jobnamen als gut lesbarer Benutzeroberflächentext erscheinen. Die Ausgabe steht in einem umbrochenen Monospace-Block mit einem Tastaturfokusziel. Lange Pfade können umgebrochen werden, statt die ganze Seite breiter als ein Smartphone zu machen. Bei einer Auswahl wird der Text ersetzt, anstatt rohes HTML einzufügen.
Abstände und Rahmenrhythmus im GitLab Pajamas-Designsystem
Tokenwerte nicht anhand ihrer Nummer berechnen
GL_SPACING_SCALE_3 entspricht 0.5rem und scale_5 entspricht 1rem; der Index ist ein Schlüssel, kein direkter Multiplikator. Verwende bei der Implementierung der Skala den exportierten Wert. Die Referenztabelle enthält die exakten Einheiten, auch für die Stufe mit null Pixeln.
Bereiche durch Abgrenzungen klarer strukturieren
Jobauswahl und -filterung im GitLab Pajamas-Designsystem
Die Identität der Auswahl unabhängig von der Filterposition beibehalten
Das Skript verwendet stabile Zeichenfolgen-IDs wie links und accessibility. Der Filter ändert die angezeigten Jobs und wählt einen passenden Job aus, falls einer vorhanden ist. Durch Klicken auf einen Job werden gleichzeitig sein gedrückter Zustand, seine Phase, sein Status-Badge und sein Protokoll aktualisiert. So wird vermieden, dass der Titel eines Jobs zusammen mit der Ausgabe eines anderen erscheint.
Wiederherstellungskontext beibehalten, wenn das Ergebnis verschwindet
Nachdem der fehlgeschlagene Job simuliert auf „Passed“ gesetzt wurde, liefert ein Filter für fehlgeschlagene Jobs keine Ergebnisse mehr. Der Hinweis für leere Listen erklärt, wie die Liste wiederhergestellt werden kann, während der Inspektor das gerade abgeschlossene Ergebnis weiterhin anzeigt. So kann die Person nachvollziehen, warum die Zeile verschwunden ist, ohne die Bestätigung zu verlieren.
Wiederholungs- und Zurücksetzungsverhalten im GitLab Pajamas-Designsystem
Die Simulation eindeutig kennzeichnen
Die Aktion heißt „Erfolgreichen Wiederholungsversuch simulieren“, ändert nur die lokalen Testdaten und ersetzt das Protokoll durch einen Beschreibungstext zum Simulationsergebnis. Sie startet keinen Runner, erstellt keinen Job und untersucht kein Repository. Der Status der gesamten Pipeline wird anhand der Status aller Jobs neu berechnet, statt nach einem beliebigen Klick blind auf Erfolg gesetzt zu werden.
Die gesamten ursprünglichen Testdaten wiederherstellen
Zurücksetzen erstellt eine frische Kopie der ursprünglichen Jobdaten, wählt den fehlgeschlagenen Link-Job aus, stellt „Alle Jobs“ wieder her und rendert beide Bereiche neu. Das simulierte Ergebnis wird ohne Neuladen gelöscht. So lässt sich das Beispiel wiederholt vorführen und ein zweiter Betrachter hält einen zuvor simulierten Erfolg nicht für den Ausgangszustand.
Wähle „Fehlgeschlagene Jobs“ aus und prüfe die fehlgeschlagene Route.
Simuliere einen Erfolg und lies den unverändert angezeigten Inspektor sowie die leere gefilterte Liste.
Setze das Beispiel zurück und überprüfe, ob der Fehler und die ursprüngliche Ausgabe wieder angezeigt werden.
Jeder Job ist eine echte Schaltfläche mit aria-pressed. Der Status wird neben der Dauer angezeigt, und der sichtbare Tastaturfokus bleibt vom Auswahlstil getrennt. Der Filter hat eine sichtbare Beschriftung. Für diese einfachen Steuerelemente wird keine benutzerdefinierte Tastaturnavigation in einem Diagramm behauptet.
Gib das Ergebnis bekannt, ohne den Fokus zu verschieben
Das Ergebnis wird nach einem erneuten Versuch oder dem Zurücksetzen in einen Statusbereich geschrieben. Das Protokoll besteht aus auswählbarem Text und kann zum Lesen den Tastaturfokus erhalten. Die Anwendung verschiebt den Fokus jedoch nicht nach jeder Auswahl automatisch dorthin. So bleiben wiederholte Vergleiche zwischen Jobs vorhersehbar.
Designsystem und Integrationsgrenzen für Vue für GitLab Pajamas und CSS
Lege die Integrationsebene ausdrücklich fest
Dieser Quellcode importiert die veröffentlichte CSS-Distribution und ergänzt sie um ursprüngliches Verhalten mit HTML/JavaScript. Er instanziiert weder GlButton noch GlFormSelect oder andere Vue-Exporte. Eine Vue-Anwendung sollte die entsprechenden nativen Komponenten und ihre aktuellen Props und Events verwenden, statt diese DOM-Implementierung als Vue-Beispiel zu behandeln.
CSS-Distribution: natives Erscheinungsbild und semantische Variablen.
Ursprüngliches HTML: barrierefreie Steuerelemente und Bereichsstruktur.
Ursprüngliches JavaScript: Fixture-Daten, Auswahl, Filter und Simulation.
Binde Tokens an die importierte Version
GitLab Pajamas-Designsystem: Komponentenbeispiele
index.html — Pipeline-Arbeitsbereich
Vollständiges semantisches Layout und Steuerelemente.
html
<!doctype html>
<html lang="en">
<meta charset="utf-8">
<meta name="viewport" content="width=device-width,initial-scale=1">
<title>Pipeline specimen</title>
<body>
<main class="pipeline-example">
<header>
<p class="eyebrow">sample-team / documentation</p>
<div class="title-row">
<div>
<h1>Pipeline #1842</h1>
<p>
Preview build for <code>docs/update-navigation</code> ·
<code>7c31a82</code>
</p>
</div>
<span id="pipeline-state" class="state failed">Failed</span>
</div>
</header>
<div class="toolbar">
<label for="job-filter">Show jobs</label
><select id="job-filter" class="gl-form-select">
<option value="all">All jobs</option>
<option value="failed">Failed jobs</option>
<option value="passed">Passed jobs</option></select
><button id="reset" class="btn btn-default gl-button">
Reset specimen
</button>
</div>
<div class="pipeline-layout">
<section aria-label="Pipeline stages">
<div id="stages" class="stages"></div>
<p id="empty" hidden>
No jobs match this filter. Choose All jobs to restore the pipeline.
</p>
</section>
<section class="job-detail" aria-labelledby="job-title">
<div class="detail-heading">
<h2 id="job-title"></h2>
<span id="job-state" class="state"></span>
</div>
<dl>
<dt>Stage</dt>
<dd id="job-stage"></dd>
<dt>Runner</dt>
<dd>local-example-runner</dd>
<dt>Execution</dt>
<dd>Simulated in this page</dd>
</dl>
<h3>Job output</h3>
<pre id="job-log" tabindex="0" aria-label="Selected job output"></pre>
<button id="retry" class="btn btn-confirm gl-button">
Simulate successful retry
</button>
<p id="feedback" role="status"></p>
</section>
</div>
<footer>
Native @gitlab/ui 138.0.0 CSS with original HTML and state logic. Fictional
pipeline; no runner, repository or CI job is started.
</footer>
</main>
<script type="module" src="/src/main.js"></script>
</body></html>
Als src/pajamas.css speichern. Die Ausweichschrift des Systems ist ausdrücklich festgelegt; eine gebrandete GitLab-Schriftart ist nicht enthalten.
04
GitLab Pajamas-Designsystem: Einrichtung des AI-Agenten
Ausgangspunkt für die Implementierung
Diese Integration importiert ausschließlich die native CSS-Distribution. Beachte die Anforderungen an GitLab-UI-Peer-Abhängigkeiten separat, wenn du die Vue-Komponenten verwenden möchtest.
sh
npm create vite@latest pajamas-pipeline -- --template vanilla
cd pajamas-pipeline
npm install
npm install @gitlab/[email protected]
# Replace index.html; add src/main.js and src/pajamas.css from the complete examples.
npm run dev
Ein Prompt für dein Projekt
Agenten-Prompt
Erstelle einen technischen Job-Inspektor mit semantischen Oberflächen von Pajamas, echten Abstands- und Schriftreferenzen, stabilen Job-IDs und barrierefreier Auswahl. Verwende den vollständigen Fixture-Quellcode, bewahre den sichtbaren Fehlerkontext, mache leere Filterergebnisse verständlich und kennzeichne jede lokale Simulation. Erwecke nicht den Eindruck, dass CSS oder der beispielhafte erneute Versuch einen GitLab-CI-Job erstellt.
05
GitLab Pajamas-Designsystem: Quellen und Geltungsbereich
Anwendungsleitfaden zu GitLab Pajamas und @gitlab/ui 138.0.0 für OpenDesign. Das native Paket CSS gestaltet dieses originale Beispiel für HTML/JavaScript. Die Pipeline ist fiktiv; es werden weder GitLab-API noch eine Vue-Laufzeitumgebung, ein CI-Runner oder eine Repository-Aktion aufgerufen.