Bir operasyon çalışma alanı için PatternFly kullanın: anlamsal belirteç referansları, seçilebilir hizmet kartları, üç durumlu toplu seçim, kapsam incelemesi ve eksiksiz yerel React kodu.
OpenDesign Kılavuzu8 Bölüm38 Referans KaydıÖzgün Uygulama Kılavuzu
01
Red Hat PatternFly Tasarım Sistemi Arayüzü Önizlemesi
Hizmet galerisinde arama yapın, tek tek veya görünür hizmetleri seçin, çoğaltma toplamlarını inceleyin, seçimi gözden geçirin ve yerel bir planı onaylayın.
Özgün Gallery/Card ve toplu seçim durumuna sahip yerel PatternFly React 6.6.1. Yalnızca örnek operasyonel veriler. · Uygulama başvurusu
02
Red Hat PatternFly Tasarım Sistemi Tasarım Başvurusu
PatternFly React 6.6.1 ve @patternfly/react-tokens 6.6.1. Yayımlanmış açık tema belirteçlerinin seçili çözümlemeleri aşağıda gösterilmiştir. Yerel bileşenler ve pf-v6-theme-dark koyu stili belirler; örnek hizmet verileri ve düzen ise uygulama tercihleridir.
Red Hat PatternFly Tasarım Sistemi Operasyon Düzeni
Sürekli operasyonel bağlam sunan bir koleksiyon
Hizmet galerisi, operatörün durumu, konumu ve kullanım oranını karşılaştırmasını sağlarken ayrı bir kapsam paneli seçilen kümeyi kaydeder. Seçim, geçerli arama sonuçlarıyla aynı şey değildir. Filtrelenen bir hizmet, bilerek kaldırılana kadar seçili kalır. Görünür ekranın ötesinde sonuçları olan toplu bir işlem için bu ayrım kritik önem taşır.
Yerel bileşen hiyerarşisini kullanın
Gallery duyarlı kart sütunlarını yönetir, Card her hizmeti birbirinden ayırır, Label durumu belirtir ve Progress başlığıyla birlikte örnek bir yüzdeyi gösterir. Sayfa, rastgele renkli dikdörtgenlerle bir altyapı konsolunu taklit etmez. Veri modeli, kontroller ve inceleme durumu, React örneğinin tamamında uygulanmıştır.
Red Hat PatternFly Tasarım Sistemi Anlamsal Renk ve Tema Rolleri
Birincil marka rengi ve vurgu kırmızısı farklı rollerdir
PatternFly v6; marka, vurgu, metin, arka plan ve durum için ayrı roller sunar. Seçili açık tema görüntüsünde varsayılan mavi marka rengi ve varsayılan kırmızı marka vurgusu bulunur. Öne çıkan her işlemi Red Hat kırmızısı olarak değerlendirmek bu rolleri birbirine karıştırır. Yerel Button ve Label bileşenleri, varyantlarına uygun sistem rollerini kullanır.
Koyu temayı belge düzeyinde çözümleyin
Örnek, belge öğesinde pf-v6-theme-dark sınıfını açıp kapatır. Uygulama yüzeyleri ve metinleri --pf-t--global anlamsal değişkenlerini kullanır; böylece tema bunların renklerini de belirler. Açık tema değerlerini özel kartlara sabitleyip belge tema sınıfının bunları düzeltmesini beklemeyin.
Red Hat PatternFly Tasarım Sistemi Yazı Tipi ve Hizmet Meta Verileri
Görsel boyutu başlık anlambiliminden ayırın
Title bileşenindeki headingLevel h1, sayfa başlığını belirler; boyutu ise görsel vurguyu kontrol eder. Bu paketin anlık görüntüsünde Body-default 0.875rem'dir. Kart etiketleri, durum ve sayısal kullanım değerleri, her değeri başlığa dönüştürmeden de okunabilir kalır. Metadata tanım listesi, replika sayılarını ve hizmet kimliklerini açıkça belirtir.
Belirsiz operasyon etiketlerinden kaçının
Örnek kullanım, hem bileşende hem alt bilgide örnek veri olarak etiketlenir. Tek başına bir ilerleme çubuğu, dağıtım görevi veya yükleme işlemi sanılabilir. Açıklama metni yüzdenin neyi ifade ettiğini belirtirken durum Label'ı kapasitenin Sağlıklı mı yoksa Gözden geçirilmeli mi olduğunu ayrıca bildirir.
Red Hat PatternFly Tasarım Sistemi Galerisi ve Toplu Seçim
Üç onay kutusu durumunu kullanın
Görünür olan tüm hizmetler seçildiğinde Select visible true, hiçbiri seçilmediğinde false, yalnızca bazıları seçildiğinde null değerini alır. PatternFly Checkbox, belirsiz durum için null değerini destekler. Uygulama bu durumu filtrelenmiş koleksiyondan hesaplar; satır seçimlerinden farklılaşabilecek ayrı bir boolean kullanmaz.
Bir hizmet seçin ve kısmi seçim durumunu inceleyin.
Şu anda görünür olan tüm hizmetleri seçin.
Bir adı arayın ve gizli seçimlerin korunduğunu doğrulayın.
Kesin kümeyi ve replika toplamını inceleyin.
Yerel planı onaylayın ve sonucu okuyun.
Seçim kümesini tek doğruluk kaynağı yapın
Red Hat PatternFly Tasarım Sistemi Aralığı ve Duyarlı Kartlar
Sayfa iskeleti için anlamsal belirteçleri kullanın
Örnek arka plan, normal metin ve ikincil metadata, yayımlanan belirteç paketindeki anlamsal CSS özelliklerini kullanır. Yerel aralık ölçeği xs ile 4xl arasında değişirken uygulama, koleksiyon ile kapsam paneli arasında 24px kullanır. Bu açıkça belirtilen düzen değeri, belirteç referansından ayrıdır.
İçeriği daraltmadan önce galerinin yeniden akışını sağlayın
Gallery için en az 230px öğe genişliği ve bir aralık belirlenir. Uygulamadaki 850px kesme noktasında kapsam paneli koleksiyonun altına taşınır. 500px'te sayfa dolgusu 16px olur ve arama araç çubuğunun tüm genişliğini kaplar. Bunlar örnek düzen kararlarıdır; tüm PatternFly ürünlerinin bu kesme noktalarını kullandığı anlamına gelmez.
Red Hat PatternFly Tasarım Sistemi İnceleme ve Seçim Durumları
Seçimin işlemi başlatmasına izin vermeyin
Bir hizmeti işaretlemek yalnızca onu kapsama ekler. Review selection, bilgilendirme amaçlı bir Alert ve bir onaylama eylemi gösterir. Confirm local plan, bakım işi başlatmadan seçili hizmet ve replika toplamlarını bildirir. Seçim değiştirildiğinde inceleme durumu kapatılır; böylece artık geçerli olmayan bir küme sessizce onaylanamaz.
Arama kurtarma işlemini seçimden ayrı tutun
Eşleşmeyen bir sorgu, aramayı temizleme seçeneği bulunan satır içi bilgilendirme amaçlı bir Alert gösterir. Bu işlem yalnızca sorguyu temizler; seçili hizmetleri korur. Bu nedenle araç çubuğundaki seçim sayısı ve kapsam paneli aynı bilgiyi vermeye devam eder. Arama boşaldığında seçimi yan etki olarak sıfırlamak, gizli ve yıkıcı bir davranış olur.
Red Hat PatternFly Tasarım Sistemi Erişilebilir Kontroller ve Durum
Seçimi etiketleyin ve yerel kontrolleri kullanın
Her Checkbox'ın sabit bir kimliği ve görünür bir hizmet etiketi vardır. SearchInput'ın erişilebilir bir adı bulunur, Switch görünüm ayarını adlandırır ve küme boşken Review selection devre dışıdır. Yerel Progress, değerini ve başlığını bildirir. Sayfa, kart içinde gizlenmiş ve yalnızca üzerine gelindiğinde görünen bir eyleme bağlı değildir.
Durumu sözcüklerle görünür kılın
Seçim sayısı, kibar bir canlı bölge kullanır; hizmet durumu bir Label içinde metin olarak belirtilir ve son Alert gerçekleşenleri açıklar. Seçim kapsamını veya sistem sağlığını yalnızca renkle göstermeyin. Klavye testlerinde kısmi seçimi, seçili bir hizmeti filtreleyerek gizlemeyi ve koleksiyonun tamamına geri dönmeyi kapsayın.
Seçili bir onay kutusu, dahil etme kararını belirtir; başarı durumunu değil.
Durum Label'ı, hizmeti açıklar; seçili olup olmadığını değil.
Progress, işlem tamamlanmasını değil, örnek kullanım değerini gösterir.
Red Hat PatternFly Tasarım Sistemi React Entegrasyonu
Sıfırlama ve bileşen stillerini bir kez içe aktarın
Örnek, giriş noktasında @patternfly/react-core/dist/styles/base.css dosyasını içe aktarır. Yerel React bileşenleri, stillerini paket üzerinden sağlar. Uygulama CSS pf-example kapsamındadır ve güncel --pf-t--global ad alanını kullanır; bileşenlerin iç yapısını geçersiz kılmaz.
Gerçek zamanlamayı yalnızca bir hizmet sözleşmesinin arkasında ekleyin
Red Hat PatternFly Tasarım Sistemi Bileşen Örnekleri
main.jsx — hizmet galerisi ve toplu inceleme
Türetilmiş seçim kapsamı ve yerel onay içeren eksiksiz yerel Gallery/Card/Checkbox/Progress bileşimi.
src/patternfly.css olarak kaydedin. Uygulama kesme noktaları bu örnekte açıkça belirtilmiştir.
04
Red Hat PatternFly Tasarım Sistemi Agent Kurulumu
Uygulamaya Başlangıç Noktası
Yerel React 18.3.1 / PatternFly 6.6.1 bileşimi. Vite için desteklenen bir Node.js sürümü gerekir. Gerçek hizmet verileri ve işlemler API uygulamanın sorumluluğundadır.
sh
npm create vite@latest patternfly-services -- --template react
cd patternfly-services
npm install
npm install [email protected][email protected] @patternfly/[email protected]
# Replace src/main.jsx and add src/patternfly.css using the complete examples.
npm run dev
Projeniz İçin Bir İstem
Ajan İstemi
PatternFly 6.6.1'in yerel Gallery, Card, Checkbox, Progress, Label ve Alert bileşenlerini kullanarak bir operasyon koleksiyonu oluşturun. Sağlanan anlamsal belirteçleri ve eksiksiz örneği kullanın. Filtrelenmiş görünürlüğü seçili kimliklerden ayrı tutun, toplu seçimin kısmi durumunu hesaplayın ve etkilenen kesin kümenin incelenmesini zorunlu kılın. Gerçek bir API eklendiğinde beklemede/başarısız/başarılı durumlarını doğru biçimde bildirin. Mobilde yeniden akışı ve klavye erişimini koruyun.
05
Red Hat PatternFly Tasarım Sistemi Kaynakları ve Kapsamı
OpenDesign tarafından hazırlanmış bir uygulama kılavuzu ve kurgusal bakım planlama örneği; yerel PatternFly React 6.6.1 ile çalışır. Kullanım, bölge ve replika sayıları örnek verilerdir. Onaylama yalnızca yerel durumu günceller; hiçbir hizmet yeniden başlatılmaz veya zamanlanmaz.