Command

Rol ve anlam

Command, Base UI Combobox’ın satır içi listesiyle çizilir: arama girişi role="combobox", liste role="listbox", her grup başlığına bağlı role="group", komutlar role="option"’dır. Vurgulanan komut aria-activedescendant ile duyurulur; odak girişte kalır. Kısayol tuşları kbd öğeleridir ve komut adıyla birlikte okunur. CommandDialog, Base UI Dialog ile role="dialog" ve aria-modal taşır; adı “Komut paleti”dir. Tuş ipuçları satırı aria-hidden taşır; aynı bilgi rollerden gelir.

Klavye

Tuş	Davranış
⌘K ya da Ctrl+K	CommandDialog’u açar ve kapatır (hotkey).
Yazma	Komutları süzer; ilk eşleşen vurgulanır.
Aşağı ve yukarı ok	Komutlar arasında gezer.
Enter	Vurgulanan komutu çalıştırır.
Escape	CommandDialog’u kapatır.

Odak

CommandDialog açılınca odak arama girişine geçer ve pencerenin içinde kalır. Kapanınca odak açan öğeye döner. Pencere dışındaki sayfa etkileşime kapanır.

Ekran okuyucu

Örnek	Okunan
Pencere açılır	“Komut paleti, iletişim kutusu, Komut paleti, birleşik giriş kutusu”
Komut vurgulanır	“Kaydet ⌘ S, Eylemler, 1 / 3”
Devre dışı komut	“Oturumu kapat, soluk”
Sonuç yok	“Sonuç bulunamadı”

Kontrast

Komut etiketleri ve grup başlıkları zeminde en az 4,5:1 kontrast taşır. Vurgu yalnız renkle değil aria-activedescendant ile de bildirilir. Karartılmış arka plan pencereyi sayfadan ayırır.

WCAG 2.2

Ölçüt	Command nasıl karşılar	Ürün ekibi ne yapmalı
1.3.1 Bilgi ve ilişkiler	Gruplar başlıklarına bağlı group rolündedir.	Grup başlıklarını anlamlı verin.
2.1.1 Klavye	Kısayol, ok tuşları, Enter ve Escape.	Kısayolun uygulamadaki başka bir kısayolla çakışmadığını denetleyin.
2.1.4 Karakter tuşu kısayolları	Kısayol değiştirici tuş (⌘ ya da Ctrl) ister.	Tek harfli kısayol eklemeyin.
2.4.3 Odak sırası	Odak pencerede kalır ve açan öğeye döner.	Paleti açan görünür bir düğme de koyun.
4.1.2 Ad, rol, değer	Giriş, liste, grup ve komut rolleri.	Komut etiketlerini benzersiz tutun.