無障礙屬性

組件可以設(shè)置相應(yīng)的無障礙屬性和事件來更好地使用無障礙能力。

說明：
開發(fā)前請(qǐng)熟悉鴻蒙開發(fā)指導(dǎo)文檔 ：[gitee.com/li-shizhen-skin/harmony-os/blob/master/README.md]
從API Version 10 開始支持。后續(xù)版本如有新增內(nèi)容，則采用上角標(biāo)單獨(dú)標(biāo)記該內(nèi)容的起始版本。

屬性

搜狗高速瀏覽器截圖20240326151547.png

名稱	參數(shù)類型	描述`HarmonyOS與OpenHarmony鴻蒙文檔籽料：mau123789是v直接拿`
accessibilityGroup	boolean	無障礙組，設(shè)置為true時(shí)表示該組件及其所有子組件為一整個(gè)可以選中的組件，無障礙服務(wù)將不再關(guān)注其子組件內(nèi)容。默認(rèn)值：false
accessibilityText	string	無障礙文本，當(dāng)組件不包含文本屬性時(shí)，屏幕朗讀選中此組件時(shí)不播報(bào)，使用者無法清楚地知道當(dāng)前選中了什么組件。為了解決此場(chǎng)景，開發(fā)人員可為不包含文字信息的組件設(shè)置無障礙文本，當(dāng)屏幕朗讀選中此組件時(shí)播報(bào)無障礙文本的內(nèi)容，幫助屏幕朗讀的使用者清楚地知道自己選中了什么組件。默認(rèn)值：“”說明：若組件既擁有文本屬性，又擁有無障礙文本屬性，則組件被選中時(shí)，僅播報(bào)無障礙文本內(nèi)容。若組件設(shè)置了無障礙分組屬性為true，但是即沒有無障礙文本屬性，也沒有文本屬性，會(huì)對(duì)其子節(jié)點(diǎn)的組件進(jìn)行文本拼接（深度優(yōu)先）。
accessibilityDescription	string	無障礙說明，用于為用戶進(jìn)一步說明當(dāng)前組件，開發(fā)人員可為組件的該屬性設(shè)置相對(duì)較詳細(xì)的解釋文本，幫助用戶理解將要執(zhí)行的操作。如幫助用戶理解將要執(zhí)行的操作可能導(dǎo)致什么后果，尤其是當(dāng)這些后果無法從組件本身屬性與無障礙文本中了解到時(shí)。若組件既擁有文本屬性又擁有無障礙說明屬性，則組件被選中時(shí)，先播報(bào)組件的文本屬性，再播報(bào)無障礙說明屬性的內(nèi)容。默認(rèn)值：“”
accessibilityLevel	string	無障礙重要性，用于控制某個(gè)組件是否可被無障礙輔助服務(wù)所識(shí)別。支持的值為: "auto"：根據(jù)組件不同會(huì)轉(zhuǎn)換為“yes”或者“no”。 "yes"：當(dāng)前組件可被無障礙輔助服務(wù)所識(shí)別。 "no"：當(dāng)前組件不可被無障礙輔助服務(wù)所識(shí)別。 "no-hide-descendants"：當(dāng)前組件及其所有子組件不可被無障礙輔助服務(wù)所識(shí)別。默認(rèn)值："auto"說明：以下組件當(dāng)accessibilityLevel設(shè)置成"auto"時(shí)，當(dāng)前組件可被無障礙輔助服務(wù)所識(shí)別：Checkbox, CheckboxGroup, Gauge, Marquee, MenuItem, MenuItemGroup, Menu, Navigation, DatePicker, Progress, Radio, Rating, ScrollBar, Select, Slider, Stepper, Text, TextClock, TextPicker, TextTimer, TimePicker, Toggle, Web.

審核編輯黃宇

聲明：本文內(nèi)容及配圖由入駐作者撰寫或者入駐合作網(wǎng)站授權(quán)轉(zhuǎn)載。文章觀點(diǎn)僅代表作者本人，不代表電子發(fā)燒友網(wǎng)立場(chǎng)。文章及其配圖僅供工程師學(xué)習(xí)之用，如有內(nèi)容侵權(quán)或者其他違規(guī)問題，請(qǐng)聯(lián)系本站處理。舉報(bào)投訴