無(wú)障礙屬性
組件可以設(shè)置相應(yīng)的無(wú)障礙屬性和事件來(lái)更好地使用無(wú)障礙能力。
說(shuō)明:
開發(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)容的起始版本。
屬性
名稱 | 參數(shù)類型 | 描述HarmonyOS與OpenHarmony鴻蒙文檔籽料:mau123789是v直接拿 |
---|---|---|
accessibilityGroup | boolean | 無(wú)障礙組,設(shè)置為true時(shí)表示該組件及其所有子組件為一整個(gè)可以選中的組件,無(wú)障礙服務(wù)將不再關(guān)注其子組件內(nèi)容。 默認(rèn)值:false |
accessibilityText | string | 無(wú)障礙文本,當(dāng)組件不包含文本屬性時(shí),屏幕朗讀選中此組件時(shí)不播報(bào),使用者無(wú)法清楚地知道當(dāng)前選中了什么組件。為了解決此場(chǎng)景,開發(fā)人員可為不包含文字信息的組件設(shè)置無(wú)障礙文本,當(dāng)屏幕朗讀選中此組件時(shí)播報(bào)無(wú)障礙文本的內(nèi)容,幫助屏幕朗讀的使用者清楚地知道自己選中了什么組件。 默認(rèn)值:“”**說(shuō)明:**若組件既擁有文本屬性,又擁有無(wú)障礙文本屬性,則組件被選中時(shí),僅播報(bào)無(wú)障礙文本內(nèi)容。 若組件設(shè)置了無(wú)障礙分組屬性為true,但是即沒(méi)有無(wú)障礙文本屬性,也沒(méi)有文本屬性,會(huì)對(duì)其子節(jié)點(diǎn)的組件進(jìn)行文本拼接(深度優(yōu)先)。 |
accessibilityDescription | string | 無(wú)障礙說(shuō)明,用于為用戶進(jìn)一步說(shuō)明當(dāng)前組件,開發(fā)人員可為組件的該屬性設(shè)置相對(duì)較詳細(xì)的解釋文本,幫助用戶理解將要執(zhí)行的操作。如幫助用戶理解將要執(zhí)行的操作可能導(dǎo)致什么后果,尤其是當(dāng)這些后果無(wú)法從組件本身屬性與無(wú)障礙文本中了解到時(shí)。若組件既擁有文本屬性又擁有無(wú)障礙說(shuō)明屬性,則組件被選中時(shí),先播報(bào)組件的文本屬性,再播報(bào)無(wú)障礙說(shuō)明屬性的內(nèi)容。 默認(rèn)值:“” |
accessibilityLevel | string | 無(wú)障礙重要性,用于控制某個(gè)組件是否可被無(wú)障礙輔助服務(wù)所識(shí)別。 支持的值為: "auto":根據(jù)組件不同會(huì)轉(zhuǎn)換為“yes”或者“no”。 "yes":當(dāng)前組件可被無(wú)障礙輔助服務(wù)所識(shí)別。 "no":當(dāng)前組件不可被無(wú)障礙輔助服務(wù)所識(shí)別。 "no-hide-descendants":當(dāng)前組件及其所有子組件不可被無(wú)障礙輔助服務(wù)所識(shí)別。 默認(rèn)值:"auto"**說(shuō)明:**以下組件當(dāng)accessibilityLevel設(shè)置成"auto"時(shí),當(dāng)前組件可被無(wú)障礙輔助服務(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. |
審核編輯 黃宇
-
鴻蒙
+關(guān)注
關(guān)注
57文章
2321瀏覽量
42749
發(fā)布評(píng)論請(qǐng)先 登錄
相關(guān)推薦
評(píng)論