Bileşenler
Table
Küçük, salt okunur verileri anlamsal bir HTML tablosunda gösterir.
- Storybook
- Storybook
- Kaynak kod
- Kaynak kod
Ne zaman kullanılır
Bölüm başlığı “Ne zaman kullanılır”Table, kısa ve salt okunur bir veri kümesini satırlar ve sütunlar halinde gösterir: bir ayrıntı sayfasındaki kayıtlar, bir kıyaslama, bir özet. Sayfa yüklendiğinde tüm veri zaten ekrandadır ve kullanıcı yalnızca okur.
Ne zaman kullanılmaz
Bölüm başlığı “Ne zaman kullanılmaz”- Sıralama, süzme, sayfalama ya da seçim gerekiyorsa: DataTable kullanın. DataTable, Table ile aynı parçaları kullanır; aradaki fark davranıştır, görünüm değildir.
- Anahtar-değer çiftleri için: DescriptionList kullanın; iki sütunlu bir tablo yerine anlamsal bir tanım listesi verir.
- Tekrarlanan, tek sütunlu satırlar için: ListItem kullanın.
- Yalnızca yerleşim için: Izgara ve Stack kullanın; tablo veri içindir, yerleşim için değil.
Table ile DataTable
Bölüm başlığı “Table ile DataTable”| Table | DataTable | |
|---|---|---|
| Veri | Küçük, salt okunur, sayfada hazır | Büyük, sunucudan gelen ya da değişen |
| Etkileşim | Yok; yalnızca kaydırma | Sıralama, süzme, sayfalama, seçim |
| Durum | Yok | Satır seçimi, sütun düzeni |
| Parçalar | Table.* |
Aynı Table.* parçaları |
Anatomi
Bölüm başlığı “Anatomi”- Kaydırma bölgesi (kök): tabloyu saran, adlandırılmış ve odaklanabilir
div. - Başlık (
caption): tabloyu adlandırır; görünür ya da gizli. - Üst bilgi (
Table.Header): sütun başlıklarını (Table.HeaderCell) içeren satır. - Gövde (
Table.Body): veri satırları (Table.Row), satır başlığı (Table.RowHeader) ve hücreler (Table.Cell). - Alt bilgi (
Table.Footer): toplam gibi özet satırları.
Davranış
Bölüm başlığı “Davranış”- Table durağandır: satırlar tıklanmaz, tablo sıralanmaz. Etkileşim gerekiyorsa DataTable kullanın.
- Tablo kapsayıcısından genişse ya da yüksekse kaydırma bölgesi kayar. Bölge adlandırılmıştır ve Tab ile odak alır.
stickyHeaderüst bilgi hücrelerini kapsayıcının üstünde tutar; kapsayıcıya bir yükseklik vermeniz gerekir.hoverableyalnızca renk değiştirir; satır asla yükselmez.selectedsatır yalnızca görsel olarak seçilidir;aria-selecteddüz tabloda kullanılmaz.- Uzun metin
truncateile tek satırda kesilir; sütunun bir genişliği olmalıdır.
Yönergeler
Bölüm başlığı “Yönergeler”Her tabloya bir başlık verin
Bölüm başlığı “Her tabloya bir başlık verin”caption zorunludur. Tabloyu ekran okuyucuya adlandırır ve kaydırma bölgesinin adı olur.
| Ad | Durum |
|---|---|
| Birinci öğe |
Başlıksız tablo bu bileşenle kurulamaz.
Sayıları sağa yaslayın
Bölüm başlığı “Sayıları sağa yaslayın”Sayısal sütunlarda numeric kullanın: rakamlar alt alta gelir ve karşılaştırılır.
| Ad | Adet |
|---|---|
| Birinci öğe | 1.240 |
| İkinci öğe | 86 |
| Ad | Adet |
|---|---|
| Birinci öğe | 1.240 |
| İkinci öğe | 86 |
Satırı adlandırın
Bölüm başlığı “Satırı adlandırın”İlk hücreyi Table.RowHeader yapın; ekran okuyucu her hücreyi satırın adıyla birlikte okur.
| Ad | Sahibi |
|---|---|
| Birinci öğe | Kullanıcı 1 |
| Ad | Sahibi |
|---|---|
| Birinci öğe | Kullanıcı 1 |
Durumu metinle gösterin
Bölüm başlığı “Durumu metinle gösterin”Hücredeki durum için Badge ya da StatusBadge kullanın; durumu yalnızca arka plan rengine yüklemeyin.
| Birinci öğe |
|---|
| Birinci öğe |
|---|
İçerik
Bölüm başlığı “İçerik”- Sütun başlığını kısa yazın, cümle düzeninde: “Oluşturulma tarihi”, “Sahibi”. Büyük harfe çevirmeyin; Türkçede büyük harf dönüşümü yanlış harf verebilir.
- Başlığı bir isim öbeği olarak yazın: “Öğe listesi”.
- Boş hücreyi boş bırakmayın; anlamı varsa “Yok” ya da “-” yazın.
- Tarihleri ve sayıları aynı sütunda aynı biçimde yazın.
İlgili bileşenler
Bölüm başlığı “İlgili bileşenler”- DataTable: Sıralama, süzme, sayfalama ve seçim gerektiren veriler için; aynı parçaları kullanır.
- Badge: Hücredeki durum için.
- StatusBadge: Sabit sözlükten durum için.
- DescriptionList: Anahtar-değer çiftleri için.