Automasi UI untuk Spesifikasi Aplikasi Internet Kaya yang Dapat Diakses W3C
Situs web meningkatkan utilitas mereka dengan konten dinamis dan kontrol UI tingkat lanjut yang didukung oleh teknologi seperti JavaScript asinkron dan XML (AJAX), DHTML, dan JavaScript. Namun, teknologi bantu sering tidak dapat berinteraksi dengan kontrol kompleks ini atau mengekspos konten dinamis kepada pengguna. Aplikasi Internet Kaya yang Dapat Diakses (ARIA) adalah spesifikasi teknis W3C untuk mengembangkan konten web dan aplikasi sehingga dapat diakses oleh penyandang disabilitas.
Untuk mendukung spesifikasi ARIA, spesifikasi Microsoft UI Automation memungkinkan pengembang untuk mengaitkan atribut UI Automation AriaRole dan AriaProperties dengan peran dan status W3C ARIA, atau properti. Ini membantu aplikasi pengguna seperti Microsoft Internet Explorer mendukung model objek ARIA dalam konteks Automasi UI sambil mempertahankan model objek aksesibilitas garis besar.
Lampiran ini menyediakan pemetaan informasi W3C yang disarankan ke spesifikasi Microsoft Active Accessibility dan UI Automation, memanfaatkan dua properti Automation UI baru.
Topik ini berisi bagian berikut:
- Peran W3C ARIA Dipetakan ke Aksesibilitas Aktif Microsoft dan Otomatisasi UI
- W3C ARIA States and Properties Mapped to Microsoft Active Accessibility and UI Automation
- Pertimbangan Tambahan
Peran W3C ARIA Dipetakan ke Aksesibilitas Aktif Microsoft dan Otomatisasi UI
Peran W3C ARIA dapat memetakan ke peran Aksesibilitas Aktif Microsoft atau jenis kontrol Otomatisasi UI. Dengan Automasi UI, peran W3C ARIA asli juga dapat didukung oleh properti AriaRole. Agen pengguna dapat menawarkan deskripsi peran W3C ARIA yang dilokalkan dengan properti UI Automation LocalizedControlType; namun, itu bersifat opsional. Ketika string yang dilokalkan tidak ditentukan, sistem akan menyediakan string LocalizedControlType default. Agen pengguna juga dapat menawarkan peran sekunder di properti AriaRole dengan menggunakan ruang sebagai pemisah, seperti yang didefinisikan dalam standar ARIA W3C.
W3C ARIA States and Properties Mapped to Microsoft Active Accessibility and UI Automation
Status dan properti W3C ARIA dipetakan ke berbagai properti dan fungsi Microsoft Active Accessibility dan UI Automation. Sebagian besar status dan properti ARIA didukung oleh properti Automation AriaProperties UI. Pengecualian adalah properti ARIA yang mengambil referensi objek (misalnya, properti ARIA yang dijelaskan), dan properti ARIA yang didukung oleh model objek aksesibilitas. Misalnya, properti activedescendent ARIA diharapkan direpresentasikan sebagai elemen dengan fokus dalam model objek aksesibilitas. Properti milik ARIA juga harus tercermin dalam model objek aksesibilitas ketika ditentukan.
AriaProperties adalah properti string yang memiliki kumpulan pasangan nama/nilai yang pemisahnya adalah tanda sama dengan (=) dan titik koma (;), misalnya, "checked=true;disabled=false". Garis miring terbalik (\) digunakan sebagai escape ketika karakter pemisah ini, atau garis miring terbalik, muncul dalam nilai. Kode penyedia dapat menambahkan verifikasi untuk memvalidasi properti ARIA asli dalam Model Objek Dokumen, tetapi tidak diperlukan.
| Status dan Properti W3C ARIA | Properti Aksesibilitas Aktif Microsoft | Properti Automasi UI | Properti Automasi UI AriaProperties |
|---|---|---|---|
| activedescendent | STATE_SYSTEM_FOCUSED (accState) | HasKeyboardFocus (properti elemen anak yang ditunjuk untuk menerima fokus) | n/a |
| Atom | n/a | n/a | Atom |
| busy | STATE_SYSTEM_BUSY (accState) | n/a | busy |
| saluran | n/a | n/a | saluran |
| Dicentang | STATE_SYSTEM_CHECKED (accState) | ToggleState (Ubah pola kontrol) | Dicentang |
| controls | n/a | PengontrolUntuk | n/a |
| dijelaskan oleh | n/a | DescribedBy | n/a |
| dinonaktifkan | STATE_SYSTEM_UNAVAILABLE (accState) | IsEnabled | dinonaktifkan |
| dropeffect | n/a | n/a | dropeffect |
| diperluas | STATE_SYSTEM_COLLAPSED atau STATE_SYSTEM_EXPANDED (accState) | ExpandCollapseState (pola kontrol ExpandCollapse ) | diperluas |
| flowto | n/a | FlowsTo | n/a |
| Ambil | n/a | n/a | Ambil |
| haspopup | STATE_SYSTEM_HASPOPUP (accState) | n/a | haspopup |
| hidden | STATE_SYSTEM_INVISIBLE (accState) | Layar IsOff | hidden |
| invalid | n/a | IsDataValidForForm | invalid |
| labelledby | n/a | LabeledBy | n/a |
| Tingkat | accValue | n/a (diwakili oleh struktur pohon elemen otomatisasi) | tingkat |
| Live | n/a | n/a | Live |
| Multiline | n/a | Jenis kontrol dokumen | Multiline |
| multipilih | STATE_SYSTEM_EXTSELECTABLE (accState) | CanSelectMultiple (Pola kontrol pemilihan ) | multipilih |
| Memiliki | n/a (harus tercermin dalam pohon objek yang dapat diakses) | n/a (harus tercermin dalam pohon elemen otomatisasi) | n/a |
| Posinset | n/a (diwakili dalam struktur pohon objek yang dapat diakses atau oleh childId) | n/a (diwakili dalam struktur pohon elemen otomatisasi) | posinset |
| Ditekan | STATE_SYSTEM_PRESSED | ToggleState (Ubah pola kontrol) | Ditekan |
| Readonly | STATE_SYSTEM_READONLY | IsReadOnly | Readonly |
| Relevan | n/a | n/a | Relevan |
| diperlukan | n/a | IsRequiredForForm | diperlukan |
| rahasia | STATE_SYSTEM_PROTECTED | IsPassword | rahasia |
| Dipilih | STATE_SYSTEM_SELECTED | Dipilih (pola kontrol SelectionItem ) | Dipilih |
| setsize | n/a | n/a (jumlah anak dalam struktur pohon elemen otomatisasi) | setsize |
| sort | n/a | n/a | sort |
| Tabindex | STATE_SYSTEM_FOCUSABLE | IsKeyboardFocusable | Tabindex |
| valuemax | n/a | Maksimum (pola kontrol RangeValue ) | valuemax |
| valuemin | n/a | Minimum (pola kontrol RangeValue ) | valuemin |
| valuenow | IAccessible::get_accValue | Nilai (pola kontrol RangeValue ) | valuenow |
| valuetext | IAccessible::get_accValue CATATAN: Ketika properti valuenow dan valuetext ARIA diatur, accValue menyimpan data dari properti valuetext ARIA. |
Nilai (Pola kontrol nilai ) CATATAN: Pola kontrol RangeValue dan Value dapat hidup berdampingan dengan Automasi UI saat nilaitext dan valuenow ditentukan. |
valuetext |
Pertimbangan Tambahan
Automasi UI juga menawarkan model objek teks sederhana dengan pola kontrol Teks , yang mendukung penyematan objek dalam objek Dokumen. Ini memungkinkan agen pengguna dan aplikasi klien untuk memperlakukan konten web sebagai dokumen HTML atau sebagai UI desktop tradisional, tergantung pada skenario pengguna akhir.
Saran dan Komentar
Segera hadir: Sepanjang tahun 2024 kami akan menghentikan penggunaan GitHub Issues sebagai mekanisme umpan balik untuk konten dan menggantinya dengan sistem umpan balik baru. Untuk mengetahui informasi selengkapnya, lihat: https://aka.ms/ContentUserFeedback.
Kirim dan lihat umpan balik untuk