Teknik iş akışları için bir Pajamas kılavuzu: gerçek anlamsal tasarım belirteçleri, akışkan tipografi ve boşluklar, aşamalı bir işlem hattı denetleyicisi, okunaklı hata çıktısı ve açıkça yerel bir yeniden deneme simülasyonu.
OpenDesign Kılavuzu8 Bölüm43 başvuru girdisiÖzgün Uygulama Kılavuzu
01
GitLab Pajamas Tasarım Sistemi arayüz önizlemesi
İşleri duruma göre filtreleyin, çıktısını okumak için bir iş seçin, başarısız bağlantı denetiminin başarılı olmasını simüle edin ve özgün test verisini sıfırlayın.
Yerel @gitlab/ui 138.0.0 CSS; özgün aşamalı düzen, HTML ve yerel durum mantığı. Gerçek bir CI etkinliği yoktur. · Uygulama başvurusu
02
GitLab Pajamas Tasarım Sistemi tasarım referansı
@gitlab/ui 138.0.0 yayımlanmış açık tema belirteç dışa aktarımını ve yerel CSS dosyasını sağlar. GL_* adları JavaScript dışa aktarımlarıdır; derlenmiş CSS dosyasında bunların küçük harfli --gl-* karşılıkları bulunur. Örnekte özgün HTML/durum mantığıyla birlikte yerel stil sayfası kullanılır; Vue bileşenleri çalıştırılmaz.
GitLab Pajamas Tasarım Sistemi işlem hattı bilgi mimarisi
Kurtarma seçeneğinden önce hata bağlamını verin
Üstbilgide, iş denetleyicisine bağlam sağlamak için kurgusal bir işlem hattı, dal ve kayıt adı bulunur. Build, Test ve Publish grupları görünür; seçilen işin çıktısı ayrı olarak açılır. Başarısız bağlantı denetiminde, kullanıcı yeniden deneme eylemini görmeden önce hatayı açıklayan rota ve çıkış koşulu belirtilir.
Kompakt grafiği okunabilir tutun
Bu örnek, eksiksiz bir bağımlılık grafiği uyguluyormuş gibi görünmek yerine aşama sütunları ve düğmeler kullanır. Dar ekranda aşamalar belge sırasına göre alt alta gelir. Üretim işlem hattında paralel işler, bağımlılıklar, bekleme, elle başlatma ve iptal durumları gerekebilir; bunlar üç örnek başlıktan çıkarılmak yerine açıkça modellenmelidir.
GitLab Pajamas Tasarım Sistemi anlamsal renkler ve durumlar
Çalışma yüzeyi için anlamsal arayüz rollerini kullanın
Açık tema dışa aktarımı sıcak nötr yüzeyler, farklı metin vurguları ve ince kenarlıklar sağlar. Örnekte iş kartları için varsayılan yüzey, seçili durum için mavi yüzey ve koyu günlük alanı kullanılır. Kılavuz, kullanıcının ilişkiyi ekran görüntüsünden piksel örneklemesi yapmadan yeniden oluşturabilmesi için paketteki tam değerleri listeler.
Anlamı durum etiketleriyle belirtin
Her iş satırında ve rozetinde Passed ve Failed ifadeleri yer alır. Onay işareti veya çarpı bu metni destekler; yalnızca renkli rozetler belirsiz kalırdı. Marka moru, genel bir başarı göstergesi olarak kullanılmaz. Tablodaki durum referansları, seçim mavisinden özellikle ayrı tutulmuştur.
GitLab Pajamas Tasarım Sistemi yazı ölçeği ve teknik metin
Akışkan ifadeleri gerektiği yerde koruyun
Paket, sabit küçük rollerin yanı sıra clamp tabanlı daha büyük roller de sunar. clamp ifadesini en büyük uç değerle değiştirmek, duyarlı davranışı değiştirir. Özgün örnekte uygulama boyutunda 24px başlık ve 12–14px aralığında kompakt destek metinleri kullanılır; bu seçimler pakete ait ek belirteçler değil, düzen kararları olarak tanımlanır.
Tanımlayıcılar ve çıktılar için tek aralıklı yazı tipi kullanın
Dal ve kayıt adı kod biçiminde gösterilirken iş adları okunabilir arayüz metni olarak kalır. Çıktı, klavye odağı alabilen ve satırları kaydıran tek aralıklı bir blokta gösterilir. Uzun yollar, tüm sayfanın telefon ekranından daha geniş olmasına yol açmak yerine satırlara bölünebilir; seçim değiştiğinde metin yenisiyle değiştirilir, ham HTML eklenmez.
GitLab Pajamas Tasarım Sistemi boşlukları ve kenarlık düzeni
Belirteç değerlerini sıra numaralarından hesaplamayın
GL_SPACING_SCALE_3 değeri 0.5rem, scale_5 değeri ise 1rem'dir; sıra numarası doğrudan çarpan değil, bir anahtardır. Ölçeği uygularken dışa aktarılan değeri kullanın. Referans tablosunda sıfır piksel adımı da dâhil olmak üzere birimler aynen korunur.
Bölgeleri belirginleştirmek için sınırlar kullanın
GitLab Pajamas Tasarım Sistemi iş seçimi ve filtreleme
Seçili kimliği filtre sırasından bağımsız tutun
Komut dosyası, links ve accessibility gibi kararlı metin kimlikleri kullanır. Filtre, listelenen işleri değiştirir ve eşleşen bir iş varsa onu seçer. Bir işe tıklamak, o işe ait basılı durumunu, aşamayı, durum rozetini ve günlüğü birlikte günceller. Böylece bir işin başlığı altında başka bir işin çıktısının gösterilmesi önlenir.
Sonuç listeden kalkınca kurtarma bağlamını koruyun
Başarısız işin başarılı olduğu simüle edildikten sonra Failed jobs filtresi hiçbir sonuç göstermez. Boş durum mesajı listeyi nasıl geri yükleyeceğinizi açıklar; denetleyici ise tamamlanan sonucu göstermeyi sürdürür. Bu bilinçli seçim, satırın neden kaybolduğunu anlamayı sağlar ve onay bilgisinin yitirilmesini önler.
GitLab Pajamas Tasarım Sistemi yeniden deneme ve sıfırlama davranışı
Simülasyonu doğru biçimde etiketleyin
Eylemin adı Simulate successful retry olur; yalnızca yerel test verisini değiştirir ve günlüğü simülasyon sonucunu açıklayan bir metinle yeniler. Bir çalıştırıcıyı kuyruğa eklemez, iş oluşturmaz veya depoyu incelemez. Herhangi bir tıklamadan sonra başarıyı doğrudan ayarlamak yerine, genel işlem hattı rozeti tüm işlerin durumlarından yeniden hesaplanır.
Başlangıç test verisinin tamamını geri yükleyin
Sıfırlama, ilk iş verilerinin yeni bir kopyasını oluşturur, başarısız bağlantı işini seçer, All jobs filtresini geri yükler ve her iki paneli yeniden işler. Sayfa yenilenmeden simülasyon sonucu temizlenir. Böylece örnek tekrar kullanılabilir ve sonraki kullanıcıların daha önce simüle edilmiş bir başarıyı başlangıç durumu sanması önlenir.
Failed jobs filtresini seçin ve başarısız rotayı inceleyin.
Başarıyı simüle edin; korunan denetleyiciyi ve filtrelenmiş boş listeyi inceleyin.
Örneği sıfırlayın ve hatanın ve özgün çıktının geri geldiğini doğrulayın.
GitLab Pajamas Tasarım Sistemi erişilebilir iş denetimleri
Yerel seçim için düğmeleri kullanın
Her iş, aria-pressed özelliği bulunan gerçek bir düğmedir. Durum, sürenin yanında yazıyla belirtilir; görünür klavye odağı seçili görünümden ayrı tutulur. Filtrenin görünür bir etiketi vardır. Bu basit denetimler için özel, yalnızca klavyeyle kullanılan grafik gezinme desteği olduğu iddia edilmez.
Okuyucunun odağını değiştirmeden sonucu duyurun
Yeniden denemeden veya sıfırlamadan sonra sonuç bir durum bölgesine yazılır. Günlükteki metin seçilebilir ve okumak üzere klavye odağı alabilir; ancak uygulama her seçimden sonra odağı otomatik olarak günlüğe taşımaz. Böylece işler arasında art arda yapılan karşılaştırmalar öngörülebilir kalır.
GitLab Pajamas Tasarım Sistemi CSS ve Vue entegrasyon sınırları
Entegrasyon düzeyini açıkça seçin
Bu kaynak, yayımlanmış CSS dağıtımını içe aktarır ve özgün HTML/JavaScript davranışını sağlar. GlButton, GlFormSelect veya başka Vue dışa aktarımlarını örnek olarak oluşturmaz. Vue uygulaması, bu DOM uygulamasını Vue örneği olarak kullanmak yerine ilgili yerel bileşenleri ve bunların güncel props/event özelliklerini kullanmalıdır.
CSS dağıtımı: yerel görünüm ve anlamsal değişkenler.
Özgün HTML: erişilebilir denetimler ve bölge yapısı.
Özgün JavaScript: test verileri, seçim, filtreler ve simülasyon.
Belirteçleri içe aktarılan sürüme bağlı tutun
GitLab Pajamas Tasarım Sistemi bileşen örnekleri
index.html — işlem hattı çalışma alanı
Anlamsal düzen ve denetimlerin tamamı.
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>
src/pajamas.css olarak kaydedin. Sistem yazı tipi yedeği açıkça belirtilmiştir; GitLab markalı yazı tipi pakete eklenmemiştir.
04
GitLab Pajamas Tasarım Sistemi ajan kurulumu
Uygulamaya Başlangıç Noktası
Bu entegrasyon yalnızca yerel CSS dağıtımını içe aktarır. Vue bileşenlerini kullanmayı tercih ederseniz GitLab UI eş bağımlılık gereksinimlerini ayrıca izleyin.
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
Projeniz İçin Bir İstem
Ajan İstemi
Pajamas anlamsal yüzeylerini, gerçek boşluk/yazı tipi referanslarını, kararlı iş kimliklerini ve erişilebilir seçimi kullanan teknik bir iş denetleyicisi oluşturun. Eksiksiz test verisi kaynağını kullanın, görünür hata bağlamını koruyun, filtrelenmiş boş durumları anlaşılır kılın ve tüm yerel simülasyonları etiketleyin. CSS veya örnekteki yeniden deneme eyleminin bir GitLab CI işi oluşturduğu izlenimini vermeyin.
05
GitLab Pajamas Tasarım Sistemi kaynakları ve kapsamı
OpenDesign, GitLab Pajamas ve @gitlab/ui 138.0.0 için uygulama kılavuzu. Yerel paket CSS, bu özgün HTML/JavaScript örneğini biçimlendirir. İşlem hattı kurgusaldır; herhangi bir GitLab API, Vue çalışma zamanı, CI çalıştırıcısı veya depo eylemi devreye girmez.