無障礙屬性
組件可以設置相應的無障礙屬性和事件來更好地使用無障礙能力。
說明:
開發前請熟悉鴻蒙開發指導文檔 :[gitee.com/li-shizhen-skin/harmony-os/blob/master/README.md
]
從API Version 10 開始支持。后續版本如有新增內容,則采用上角標單獨標記該內容的起始版本。
屬性
名稱 | 參數類型 | 描述HarmonyOS與OpenHarmony鴻蒙文檔籽料:mau123789是v直接拿 |
---|---|---|
accessibilityGroup | boolean | 無障礙組,設置為true時表示該組件及其所有子組件為一整個可以選中的組件,無障礙服務將不再關注其子組件內容。 默認值:false |
accessibilityText | string | 無障礙文本,當組件不包含文本屬性時,屏幕朗讀選中此組件時不播報,使用者無法清楚地知道當前選中了什么組件。為了解決此場景,開發人員可為不包含文字信息的組件設置無障礙文本,當屏幕朗讀選中此組件時播報無障礙文本的內容,幫助屏幕朗讀的使用者清楚地知道自己選中了什么組件。 默認值:“”**說明:**若組件既擁有文本屬性,又擁有無障礙文本屬性,則組件被選中時,僅播報無障礙文本內容。 若組件設置了無障礙分組屬性為true,但是即沒有無障礙文本屬性,也沒有文本屬性,會對其子節點的組件進行文本拼接(深度優先)。 |
accessibilityDescription | string | 無障礙說明,用于為用戶進一步說明當前組件,開發人員可為組件的該屬性設置相對較詳細的解釋文本,幫助用戶理解將要執行的操作。如幫助用戶理解將要執行的操作可能導致什么后果,尤其是當這些后果無法從組件本身屬性與無障礙文本中了解到時。若組件既擁有文本屬性又擁有無障礙說明屬性,則組件被選中時,先播報組件的文本屬性,再播報無障礙說明屬性的內容。 默認值:“” |
accessibilityLevel | string | 無障礙重要性,用于控制某個組件是否可被無障礙輔助服務所識別。 支持的值為: "auto":根據組件不同會轉換為“yes”或者“no”。 "yes":當前組件可被無障礙輔助服務所識別。 "no":當前組件不可被無障礙輔助服務所識別。 "no-hide-descendants":當前組件及其所有子組件不可被無障礙輔助服務所識別。 默認值:"auto"**說明:**以下組件當accessibilityLevel設置成"auto"時,當前組件可被無障礙輔助服務所識別:Checkbox, CheckboxGroup, Gauge, Marquee, MenuItem, MenuItemGroup, Menu, Navigation, DatePicker, Progress, Radio, Rating, ScrollBar, Select, Slider, Stepper, Text, TextClock, TextPicker, TextTimer, TimePicker, Toggle, Web. |
審核編輯 黃宇
聲明:本文內容及配圖由入駐作者撰寫或者入駐合作網站授權轉載。文章觀點僅代表作者本人,不代表電子發燒友網立場。文章及其配圖僅供工程師學習之用,如有內容侵權或者其他違規問題,請聯系本站處理。
舉報投訴
-
鴻蒙
+關注
關注
57文章
2392瀏覽量
43050
發布評論請先 登錄
相關推薦
鴻蒙ArkTS聲明式開發:跨平臺支持列表【分布式遷移標識】 通用屬性
組件的分布式遷移標識,指明了該組件在分布式遷移場景下可以將特定狀態恢復到對端設備。
鴻蒙ArkTS聲明式開發:跨平臺支持列表【形狀裁剪】 通用屬性
參數為相應類型的組件,按指定的形狀對當前組件進行裁剪;參數為boolean類型時,設置是否按照父容器邊緣輪廓進行裁剪。 默認值:false 從API version 9開始,該接口支持在ArkTS卡片中使用。
鴻蒙ArkTS聲明式開發:跨平臺支持列表【顯隱控制】 通用屬性
控制當前組件顯示或隱藏。注意,即使組件處于隱藏狀態,在頁面刷新時仍存在重新創建過程,因此當對性能有嚴格要求時建議使用[條件渲染]代替。 默認值:Visibility.Visible 從API version 9開始,該接口支持在ArkTS卡片中使用。
鴻蒙ArkTS聲明式開發:跨平臺支持列表【Flex布局】 通用屬性
從API Version 7開始支持。后續版本如有新增內容,則采用上角標單獨標記該內容的起始版本。
> - 僅當父組件是 Flex、Column、Row 、GridRow時生效。
鴻蒙ArkTS聲明式開發:跨平臺支持列表【按鍵事件】
按鍵事件指組件與鍵盤、遙控器等按鍵設備交互時觸發的事件,適用于所有可獲焦組件,例如Button。對于Text,Image等默認不可獲焦的組件,可以設置focusable屬性為true后使用按鍵事件。
評論