Bileşenler
Text
Gövde metni, etiket, açıklama ve rakamları token tipografisiyle yazar.
- Storybook
- Storybook
- Kaynak kod
- Kaynak kod
Rol ve anlam
Bölüm başlığı “Rol ve anlam”Text varsayılan olarak <span> çizer; rolü yoktur ve metni akışta okunur. Paragraf için render={<p />}, form etiketi için render={<label />} kullanın; anlam öğeden gelir.
Klavye
Bölüm başlığı “Klavye”| Tuş | Davranış |
|---|---|
| Tab | Text odak almaz; Tab onun üzerinden geçer. |
Yok. Text odak sırasında değildir ve odak halkası göstermez.
Ekran okuyucu
Bölüm başlığı “Ekran okuyucu”Metin olduğu gibi okunur. truncate yalnızca görseli keser; kesilen kısım erişilebilirlik ağacında durur ve ekran okuyucu metnin tamamını okur.
| Örnek | Okunan |
|---|---|
<Text>Metin örneği</Text> |
“Metin örneği” |
<Text tone="danger">…</Text> |
Metin olduğu gibi; renk okunmaz |
Renk anlam taşıyorsa metin ya da ikon da aynı anlamı söylemelidir.
Kontrast
Bölüm başlığı “Kontrast”Metin renkleri packages/tokens/test/contrast.test.mjs içinde her marka ve modda en az 4.5:1 için denetlenir. Test yalnızca aşağıdaki çiftleri kapsar; diğer zeminler ölçülmedi.
| Ton | Testte denetlenen çift |
|---|---|
default |
text-default / surface-default, surface-layer-2, surface-sunken |
subtle |
text-subtle / surface-default, surface-sunken |
subtlest |
text-subtlest / surface-default, surface-raised, surface-checker |
inverse |
text-inverse / surface-inverse |
danger, success, warning, info |
text-{ton} / surface-raised |
Durum tonlarını surface-raised dışında bir zeminde kullanırsanız kontrast ölçülmedi; kendiniz doğrulayın. inverse yalnızca surface-inverse üzerinde ölçüldü.
WCAG 2.2
Bölüm başlığı “WCAG 2.2”| Ölçüt | Text nasıl karşılar | Ürün ekibi ne yapmalı |
|---|---|---|
| 1.3.1 Bilgi ve ilişkiler | render ile <p>, <label>, <time> gibi anlamlı öğe çizilir. |
Görsel olarak başlık gibi duran metin için Heading kullanın. |
| 1.4.1 Renk kullanımı | Ton yalnızca renktir; anlamı metin taşır. | Durum tonlarını metin ya da ikonla birlikte kullanın. |
| 1.4.3 Kontrast (asgari) | Yukarıdaki çiftlerde en az 4.5:1; token testi doğrular. | Test dışı zeminlerde kontrastı ölçün; className ile renk vermeyin. |
| 1.4.4 Metni yeniden boyutlandırma | Boyutlar token stilleridir; metin yakınlaştırmayla büyür. | truncate kullanılan yerde 200% yakınlaştırmada tam metne ulaşıldığını kontrol edin. |
| 1.4.12 Metin aralığı | Satır yüksekliği token’dan gelir; yükseklik sabit değildir, metin kırılır. | truncate ile satır sayısı sınırlıyken aralık büyütülmüş hâli kontrol edin. |