Bileşenler
StatusBadge
Bir durumu, ortak durum sözlüğünden ton, simge ve metinle gösterir.
- Storybook
- Storybook
- Kaynak kod
- Kaynak kod
Rol ve anlam
Bölüm başlığı “Rol ve anlam”- StatusBadge düz bir
<span>öğesidir; rolü yoktur ve etkileşimsizdir. Durum metni her zaman görünür ve okunur. - Simge süstür (
aria-hidden); ekran okuyucuya yalnızca metin gider. Anlamı ne renk ne simge tek başına taşır. announceaçıksa, rozetin yanınarole="status"vearia-live="polite"taşıyan görünmeyen bir alan eklenir. Alan sayfada rozetle birlikte vardır; durum değişince metni güncellenir ve ekran okuyucu bunu kibarca duyurur.announcevarsayılan olarak kapalıdır. Tablodaki yüzlerce rozet aynı anda duyuru yapmasın diye yalnızca kullanıcı eylemi olmadan değişen tek durumlar için açın (arka planda çalışan bir iş gibi).
Klavye
Bölüm başlığı “Klavye”| Tuş | Davranış |
|---|---|
| Tab | Rozet odak almaz; sekme sırasına girmez. |
Rozet etkileşimsiz olduğu için odak halkası yoktur. Durumu bir eylemle değiştiren denetim (örneğin bir Button) kendi odağını taşır.
Ekran okuyucu
Bölüm başlığı “Ekran okuyucu”| Örnek | Okunan |
|---|---|
| Rozet | “Onaylandı” |
announce ile durum değişimi |
“Onaylandı” (kibar duyuru; okuma sürüyorsa bekler) |
| Bilinmeyen kod | “on-hold” (ham kod; sözlüğe ekleyin) |
Kontrast
Bölüm başlığı “Kontrast”Metin her markada ve modda en az 4.5:1’dir; değerler bigbang ve fixture token çıktısından hesaplandı. Aşağıda altı tonun en düşük değeri verilir.
| Çift | Açık mod | Koyu mod |
|---|---|---|
subtle: color-status-*-foreground / color-status-*-background (en düşük) |
6.46:1 (uyarı) | 7.19:1 (hata) |
bold: color-status-*-on-emphasis / color-status-*-emphasis (en düşük) |
4.72:1 (uyarı) | 5.88:1 (bilgi) |
Tüm tonlar iki modda 4.5:1 eşiğinin üstündedir.
WCAG 2.2
Bölüm başlığı “WCAG 2.2”| Ölçüt | StatusBadge nasıl karşılar | Ürün ekibi ne yapmalı |
|---|---|---|
| 1.3.1 Bilgi ve ilişkiler | Durum metinle verilir. | Rozeti ilgili kaydın yakınına koyun; tabloda satırın hücresine. |
| 1.4.1 Renk kullanımı | Metin her zaman var; ton ve simge destekler. | Metni gizlemeyin. |
| 1.4.3 Metin kontrastı | Tüm tonlar en az 4.72:1. | Özel renk eklemeyin; durum sözlüğünü kullanın. |
| 4.1.3 Durum mesajları | announce ile durum değişimi kibarca duyurulur. |
Kullanıcı eylemi olmadan değişen durumlarda announce açın. |
| 2.3.3 Hareketle etkileşim | Yalnızca çok kısa bir solma vardır; azaltılmış harekette de çalışır. | Ek hareket eklemeyin. |