鸿蒙5.0开发进阶:API ArkUI框架-ArkTS组件(无障碍属性)

鸿蒙5.0进阶开发:UI开发-通过XComponent接入无障碍 通过XComponent接入的三方平台,NDK提供了对接无障碍的接口函数,实现三方平台的组件在ArkUI中的无障碍能力。 阅读详情

往期鸿蒙全套实战文章必看:(文中附带全栈鸿蒙学习资料)


无障碍属性

组件可以设置相应的无障碍属性和事件来更好地使用无障碍能力。

说明

从API Version 10 开始支持。后续版本如有新增内容,则采用上角标单独标记该内容的起始版本。

accessibilityGroup

accessibilityGroup(value: boolean)

无障碍组。

卡片能力: 从API version 12开始,该接口支持在ArkTS卡片中使用。

元服务API: 从API version 11开始,该接口支持在元服务中使用。

系统能力: SystemCapability.ArkUI.ArkUI.Full

参数:

参数名类型必填说明
valueboolean是

无障碍组,设置为true时表示该组件及其所有子组件为一整个可以选中的组件,无障碍服务将不再关注其子组件内容。

默认值:false

accessibilityText

accessibilityText(value: string)

无障碍文本。

卡片能力: 从API version 12开始,该接口支持在ArkTS卡片中使用。

元服务API: 从API version 11开始,该接口支持在元服务中使用。

系统能力: SystemCapability.ArkUI.ArkUI.Full

参数:

参数名类型必填说明
valuestring是

无障碍文本,当组件不包含文本属性时,屏幕朗读选中此组件时不播报,使用者无法清楚地知道当前选中了什么组件。为了解决此场景,开发人员可为不包含文字信息的组件设置无障碍文本,当屏幕朗读选中此组件时播报无障碍文本的内容,帮助屏幕朗读的使用者清楚地知道自己选中了什么组件。

默认值:“”

说明:

若组件既拥有文本属性,又拥有无障碍文本属性,则组件被选中时,仅播报无障碍文本内容。

若组件设置了无障碍分组属性为true,但是即没有无障碍文本属性,也没有文本属性,会对其子节点的组件进行文本拼接(深度优先)。

accessibilityText12+

accessibilityText(text: Resource)

无障碍文本,支持通过Resource引用资源文件。

卡片能力: 从API version 12开始,该接口支持在ArkTS卡片中使用。

元服务API: 从API version 12开始,该接口支持在元服务中使用。

系统能力: SystemCapability.ArkUI.ArkUI.Full

参数:

参数名类型必填说明
textResource是

无障碍文本引用资源,当组件不包含文本属性时,屏幕朗读选中此组件时不播报,使用者无法清楚地知道当前选中了什么组件。为了解决此场景,开发人员可为不包含文字信息的组件设置无障碍文本,当屏幕朗读选中此组件时播报无障碍文本的内容,帮助屏幕朗读的使用者清楚地知道自己选中了什么组件。

说明:

若组件既拥有文本属性,又拥有无障碍文本属性,则组件被选中时,仅播报无障碍文本内容。

若组件设置了无障碍分组属性为true,但是即没有无障碍文本属性,也没有文本属性,会对其子节点的组件进行文本拼接(深度优先)。

accessibilityDescription

accessibilityDescription(value: string)

无障碍说明。

卡片能力: 从API version 12开始,该接口支持在ArkTS卡片中使用。

元服务API: 从API version 11开始,该接口支持在元服务中使用。

系统能力: SystemCapability.ArkUI.ArkUI.Full

参数:

参数名类型必填说明
valuestring是

无障碍说明,用于为用户进一步说明当前组件,开发人员可为组件的该属性设置相对较详细的解释文本,帮助用户理解将要执行的操作。如帮助用户理解将要执行的操作可能导致什么后果,尤其是当这些后果无法从组件本身属性与无障碍文本中了解到时。若组件既拥有文本属性又拥有无障碍说明属性,则组件被选中时,先播报组件的文本属性,再播报无障碍说明属性的内容。

默认值:“”

accessibilityDescription12+

accessibilityDescription(description: Resource)

无障碍说明,支持通过Resource引用资源文件。

卡片能力: 从API version 12开始,该接口支持在ArkTS卡片中使用。

元服务API: 从API version 12开始,该接口支持在元服务中使用。

系统能力: SystemCapability.ArkUI.ArkUI.Full

参数:

参数名类型必填说明
descriptionResource是无障碍说明引用资源,用于为用户进一步说明当前组件,开发人员可为组件的该属性设置相对较详细的解释文本,帮助用户理解将要执行的操作。如帮助用户理解将要执行的操作可能导致什么后果,尤其是当这些后果无法从组件本身属性与无障碍文本中了解到时。若组件既拥有文本属性又拥有无障碍说明属性,则组件被选中时,先播报组件的文本属性,再播报无障碍说明属性的内容。

accessibilityLevel

accessibilityLevel(value: string)

无障碍重要性。

卡片能力: 从API version 12开始,该接口支持在ArkTS卡片中使用。

元服务API: 从API version 11开始,该接口支持在元服务中使用。

系统能力: SystemCapability.ArkUI.ArkUI.Full

参数:

参数名类型必填说明
valuestring是

无障碍重要性,用于控制某个组件是否可被无障碍辅助服务所识别。

支持的值为:

"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.

accessibilityVirtualNode11+

accessibilityVirtualNode(builder: CustomBuilder)

无障碍虚拟节点。

卡片能力: 从API version 12开始,该接口支持在ArkTS卡片中使用。

元服务API: 从API version 11开始,该接口支持在元服务中使用。

系统能力: SystemCapability.ArkUI.ArkUI.Full

参数:

参数名类型必填说明
builderCustomBuilder是无障碍虚拟子节点,使开发者可以对自绘制组件传入一个自定义的CustomBuilder,该CustomBuilder中的组件在后端仅做布局不做显示,辅助应用获取无障碍节点信息时会返回CustomBuilder中的节点信息。

示例

该示例主要演示accessibilityText无障碍文本和accessibilityDescription无障碍说明的播报内容。

// xxx.ets
@Entry
@Component
struct Index {

  @Builder customAccessibilityNode() {
    Column() {
      Text(`virtual node`)
    }
    .width(10)
    .height(10)
  }

  build() {
    Row() {
      Column() {
        Text("文本1")
          .fontSize(50)
          .fontWeight(FontWeight.Bold)
        Text("文本2")
          .fontSize(50)
          .fontWeight(FontWeight.Bold)
      }
      .width('100%')
      .accessibilityGroup(true)
      .accessibilityLevel("yes")
      .accessibilityText("分组")
      .accessibilityDescription("Column组件可以被选中,播报的内容是“分组”")
      .accessibilityVirtualNode(this.customAccessibilityNode)
    }
    .height('100%')
  }
}

鸿蒙5.0版开发:ArkTS组件通用属性-无障碍属性 组件可以设置相应的无障碍属性和事件来更好地使用无障碍能力。 阅读详情

相关推荐

鸿蒙HarmonyOS NEXT开发:无障碍属性(ArkTS通用属性)

组件可以设置相应的无障碍属性和事件来更好地使用无障碍能力。

shudaoshanBBQ的博客 1592

鸿蒙5.0开发进阶:API ArkUI框架-ArkTS组件(透明度设置)

设置组件的透明度。

Androidbye的博客 464

鸿蒙HarmonyOS NEXT开发环境搭建与ArkTS实战

HarmonyOS NEXT是华为推出的新一代分布式操作系统,其核心开发语言ArkTS基于TypeScript扩展了声明式UI和状态管理能力。开发环境搭建需配置DevEco Studio IDE和HarmonyOS SDK,通过@State、@Prop等装饰器实现数据绑定,采用组件化架构提升代码复用率。在鸿蒙生态中,ArkTS面向对象特性与分布式能力结合,可高效开发跨设备应用。本文以新闻客户端为例,展示从环境配置到性能优化的全流程实践,涵盖状态管理、UI组件封装等核心开发场景,帮助开发者快速掌握Harmon

weixin_33957648的博客 433

【鸿蒙next开发】ArkUI框架:ArkTS组件-无障碍属性

本文介绍了鸿蒙5.0开发中的无障碍功能,包括无障碍组、无障碍文本、无障碍说明和无障碍重要性等核心概念。

m0_73088370的博客 1073

React Native 鸿蒙适配实战:从原理到组件开发

跨端开发是移动应用降本增效的重要路径,React Native 作为业界主流的跨端框架,通过 JavaScript 与原生渲染引擎的桥接,实现了 iOS 和 Android 的代码复用。随着 HarmonyOS NEXT 不再兼容 Android APK,如何在鸿蒙生态中继续复用 RN 业务代码成为迫切需求。react-native-harmony 适配层应运而生,它基于 ArkUI 和 C-API 实现 RN 的 JSI 接口,使 JS 组件能够映射为鸿蒙原生组件。这一方案不仅大幅降低鸿蒙适配成本,也为跨

weixin_34099526的博客 296

鸿蒙生态开发进阶指南:从ArkTS/ArkUI到跨设备应用实战

摘要:本文系统介绍了华为HarmonyOS应用开发的核心技术与实践路径。首先解析HarmonyOS的分布式架构、Stage模型等设计理念,详细讲解ArkTS语言特性和ArkUI声明式框架。针对Flutter开发者提供迁移指南,重点剖析状态管理、UI构建等关键技术的异同。深入探讨移动应用开发要点及游戏开发方案,并专门分析PC形态设备的适配策略,包括大屏幕布局、键鼠交互优化和分布式协同能力实现。文章提供从环境搭建到核心功能开发的完整指导,帮助开发者快速掌握鸿蒙生态下的应用开发技能。

郑伟强dev的专栏 627

【鸿蒙next开发】ArkUI框架:ArkTS组件-无障碍悬浮事件

本文介绍了鸿蒙5.0开发中的无障碍悬浮事件处理,重点讲解了onAccessibilityHover回调的使用方法。

m0_73088370的博客 1035

new delete 详解

常规的new 和 delete 当需要内存时,可以使用new申请内存,但在用完内存时应当使用delete 去归还内存,以防止内存泄漏,具体使用方案见下面代码: int* ps = new int ; // 使用new 申明变量空间 ... ... delete ps ; '// delete 删除所申明的变量空间 上述代码将删除ps 指针指向的内存空间,但不会删除指针本身,即仍然可以使用该指针去指向其他int 类型的变量。new 和 delete 一定需要成对的使用否则极易发生内存泄漏。 注意:不

qq_42138448的博客 6939

鸿蒙5.0开发进阶:API ArkUI框架-ArkTS组件(无障碍悬浮事件)

在开启无障碍模式后,Touch事件会转换为无障碍悬浮事件。

Androidbye的博客 766

FCN---训练cityspaces

未经允许,不要随意转载! 最近想试试用FCN训练自己的数据集,想想标注是一件很费劲的事,于是就想到了用其他库里的数据,这里选用了cityspaces,默认已经配置好FCN. 1、下载cityspaces https://www.cityscapes-dataset.com/ 需要注册一个账号 cityspaces包含2...

wangyu088的专栏 2036

通俗易懂的图解二叉搜索树、AVL树和红黑树

搜索是一种很常见的需求,当数据较多时,如何找到目标对象时,即需要搜索查找。 那么如何快速找到目标呢,最朴素的思想就是暴力查找,一个一个对比。 显然,当数据量增大时,我们需要优化查找方法获取更快的查找速度,我们可以通过维护一个有序数组,从而实现二分查找,查找速度从O(n)降为O(longn)。 但是数组并不便于插入和删除,链表便成为了最好的选择。 既然是采用二分查找,那么不如直接按照查找的步骤维护一种数据结构,于是二叉搜索树出现了。 二叉搜索树的性质为: 若左子树不为空,则左子树上所有节点值都小于根结点值;

暗色光的博客 758

鸿蒙NEXT开发:ArkTS组件-通用事件(无障碍悬浮事件)

在开启无障碍模式后,Touch事件会转换为无障碍悬浮事件。

ZPYQAQ的博客 718

pcb印刷电路缺陷检测----数据集准备

PKU-Market-PCB 印刷电路板 (PCB) 瑕疵数据集是一个公共合成 PCB 数据集,包含 1,386 张图像,具有 6 种缺陷(漏孔、鼠咬、开路、短路、杂散、杂铜),可用于图像检测、分类和配准任务。

qq_30190551的博客 4439

【鸿蒙next开发】JS服务卡片UI组件:组件通用信息(无障碍)

本文详细介绍了HarmonyOS无障碍开发的核心功能,包括四大关键属性:accessibilitygroup(组件分组)、accessibilitytext(替代文本)、accessibilitydescription(详细说明)和accessibilityimportance(识别优先级),通过代码示例演示如何使用这些属性优化视障用户交互体验。

m0_73088370的博客 545

SLAM轨迹评估神器evo实战:从GPS到TUM格式的完整转换指南(附Python代码)

本文详细介绍了如何使用evo工具将GPS数据转换为TUM格式,以便进行SLAM轨迹评估。通过Python代码实现GPS到笛卡尔坐标的精确转换,并提供了完整的处理流程和实战案例,帮助开发者轻松完成从原始GPS数据到精确轨迹评估的全过程。特别适用于ORB-SLAM等视觉SLAM算法的性能验证。

weixin_29074295的博客 297

LeRobot — 基于 PyTorch 的真实世界机器人学习框架(一)- 核心框架模块解析

LeRobot 是一个开源的机器人学习框架,由 Hugging Face 开发,旨在降低机器人学的准入门槛。该框架提供完整的机器学习流程支持,包括数据采集、训练、评估和部署。核心模块涵盖数据集标准化、策略算法、硬件抽象和强化学习组件,采用模块化设计实现灵活扩展。通过集成 Hugging Face Hub,用户可以轻松共享数据集和预训练模型。LeRobot 特别注重真实世界的机器人应用,支持多种前沿算法如模仿学习、视觉语言动作模型等,并提供统一的硬件接口和仿真环境适配。

熊猫小妖的AI世界 171

鸿蒙原生开发手记:徒步迹 - 无障碍访问实现

本文介绍了鸿蒙原生应用"徒步迹"的无障碍访问实现,通过HarmonyOS提供的无障碍API确保视障用户获得平等体验。文章演示了关键代码实现:使用accessibilityText设置屏幕阅读器朗读内容,accessibilityDescription提供详细描述,accessibilityLevel定义控件层级。这些属性可应用于按钮、图片等组件,使应用具备完整的可访问性。文章强调无障碍设计是提升应用包容性的重要手段,并提供了相关开发资源链接,包括官方文档和开源项目地址,帮助开发者快速掌握鸿蒙无障碍开发技术。

2501_93816553的博客 416

全志F1C200S嵌入式驱动开发(lcd屏幕驱动)

【 声明:版权所有,欢迎转载,请勿用于商业用途。 联系信箱:feixiaoxing @163.com】 lcd RGB屏幕作为比较经济、实用的显示工具,在实际场景中使用较多。它的信号来说,一般也比较简单,除了常规的数据信号,剩下来就是行同步、场同步、数据使能和时钟信号了。数据信号方面,常见的格式有RGB888、RGB666、RGB565。为什么有什么多选择,主要还是取决于soc pin脚的多少来定。当然,pin脚越多,显示的颜色就越精准,还原度就越高。 举例来说,假设

嵌入式-老费,一个分享专业嵌入式知识的blog 2798

React Native鸿蒙 基于HarmonyOS API 24 find/join等方法是ES6通用API,在鸿蒙系统中会被React Native框架转换为ArkTS的数组操作逻辑

元类并不是新的 Python 特性,从 Python 2.2 版开始就一直都有。不过它的语法发生了重大变化,这种变化既不向后兼容也不向前兼容。新的语法如下所示:pass在 Python 2 中,其写法必须是这样的:= typePython 2 的 class 语句不接受关键字参数,所以 Python 3 定义元类的语法会在导入时引发 SyntaxError 异常。仍然可以编写在两个 Python 版本中都能运行的元类代码,但需要做一些额外工作。

2401_86113894的博客 702

完整复盘【避雷jd文职某岗位】潍坊青州hhj(据说未来搬到天津),助理实验师岗位,三人进面,面试全部不及格,空头岗位!像这种情况,该单位很多 | 附个人完整备考背诵题目 | 世间一场梦,不会再考这个了

本文以博主本人报考jun dui文职,从报考、备考、考试、查成绩到资格审查、面试,全程亲身经历,给想要报考该内容的朋友们一些小的参考。祝你顺利上岸!完整复盘【避雷jd文职某岗位】潍坊青州hhj(据说未来搬到天津),助理实验师岗位,三人进面,面试全部不及格,空头岗位!像这种情况,该单位很多 | 附个人完整备考背诵题目 | 世间一场梦,不会再考这个了

追光者♂:记录、分享、总结、提升,现象级专栏《Python从入门到人工智能》作者,无惧黑暗,坚信曙光 250

NTscan扫描工具

ntscan是一个扫描器,可以扫描没有密码和弱密码的共享,先到配置文件中填写猜测的用户名和密码,扫描过程中右侧出现的是扫描日志。

React Native鸿蒙数组map/find/join等方法是ES6通用API,HarmonyOS API 24 在鸿蒙系统中会被React Native框架转换为ArkTS的数组操作逻辑

受欢迎的 Python WSGI 兼容的网络服务器:Gunicorn(参考 http://gunicorn.org/)和 uWSGI(参考 https://uwsgi-docs.readthedocs.org),它们使用工作线程处理 HTTP 请求,这些工作线。进程,例如使用 subprocess 模块中的 run()函数,实际上这是在多个进程中进行工作,幸运的是,许多兼容 WSGI 的 Web 服务器允许这样的设置。如果在多线程中毫无顾忌的使用它,中可能会导致串行化,这将撤消多线程的所有好处。

2401_86113894的博客 536

Camera2Demo

在Camera2 的基础上进行封装,使得Camera2一堆初始化逻辑与Activity分离,降低耦合度,完成预览拍照并保存的操作

基于HarmonyOS ArkTS API 24 React Native鸿蒙跨平台使用TouchableOpacity组件在鸿蒙平台上会被透明映射为具备pressable语义的ark组件

在React Native中开发鸿组件(这里指的是鸿蒙(HarmonyOS)组件),你需要了解鸿蒙开发的基础以及如何在React Native项目中集成鸿蒙应用。鸿蒙OS是由华为开发的一个分布式操作系统,主要用于其智能设备,如手机、平板、智能手表等。首先,你需要熟悉鸿蒙OS的开发环境设置和基本开发流程。React Native本身主要用于Harmony和Harmony平台的开发,但你可以通过以下几种方式将鸿蒙应用集成到React Native项目中:A. 使用WebView。

czhm57的博客 862

STM32F407中文手册

STM32f407中文手册 本参考手册面向应用开发人员,提供有关使用 STM32F405xx/07xx、STM32F415xx/17xx、 STM32F42xxx 和 STM32F43xxx 微控制器存储器与外设的完整信息。STM32F405xx/07xx、STM32F415xx/17xx、STM32F42xxx 和 STM32F43xxx 构成一个微 控制器系列,各产品具有不同的存储器大小、封装和外设。有关订购信息以及器件的机械与电气特性,请参见数据手册。有关 ARM Cortex™-M4F 内核的信息,请参见《Cortex™-M4F 技术参考手册》。

精雕软件(JDpaint) 5.5 绿色版

精雕软件(JDpaint) 5.5 绿色版精雕软件(JDpaint) 5.5 绿色版精雕软件(JDpaint) 5.5 绿色版

基于HarmonyOS API 24 React Native鸿蒙在跨端传递时会被强制校验,避免因鸿蒙ArkTS的静态类型特性与JavaScript动态类型特性导致逻辑错误

在公共卫生与智慧医疗融合的趋势下,疫苗接种管理类应用需要兼顾医疗数据的精准性、接种计划的智能推送以及多终端的适配能力。鸿蒙系统的分布式全场景特性为医疗应用跨端部署提供了天然优势,而React Native则凭借“一次开发、多端运行”的特性,成为这类应用跨端开发的核心技术底座。本文将从数据模型设计、核心业务逻辑、UI适配到鸿蒙跨端兼容的底层实现,全方位拆解这款疫苗接种计划应用的技术架构,剖析React Native与鸿蒙生态深度融合的关键技术要点。

2401_86113894的博客 887

React Native鸿蒙,HarmonyOS ArkTS API 24 useEffect的返回清理函数对应鸿蒙组件的onDestroy生命周期

在智慧医疗场景下,个性化用药方案管理应用需要兼顾医疗数据的精准性、用药风险的实时检测以及多终端的适配能力。鸿蒙系统凭借分布式全场景架构,成为医疗应用跨端部署的核心载体,而React Native则为这类应用提供了“一次开发、多端运行”的技术底座。本文将从数据模型设计、核心业务逻辑实现、UI适配到鸿蒙跨端兼容的底层逻辑,全方位拆解这款个性化用药方案应用的技术实现,剖析React Native与鸿蒙生态融合的关键技术要点。这款个性化用药方案应用的核心架构遵循React Native的“通用抽象层+平台适配层”设

2401_86113894的博客 477

鸿蒙HarmonyOS 5.0开发实战:使用AKI轻松实现跨语言调用实现案例

针对JS与C/C++跨语言访问场景,NAPI使用比较繁琐。

m0_73088370的博客 1100

React Native鸿蒙 HarmonyOS ArkTS API 24 系统中会被解析为标准`YYYY-MM-DD`格式,保证日期在不同鸿蒙设备上跨端一致性

在基层医疗数字化转型的背景下,社区医生签约管理类应用需要兼顾医疗服务的精准性、慢病管理的连续性以及多终端的适配能力。鸿蒙系统的分布式全场景架构为基层医疗应用的跨端部署提供了核心支撑,而React Native则凭借“一次开发、多端运行”的技术特性,成为这类应用跨端开发的最优解。本文将从数据模型设计、核心业务逻辑实现、UI适配到鸿蒙跨端兼容的底层逻辑,全方位拆解这款社区医生签约管理应用的技术架构,剖析React Native与鸿蒙生态融合的关键技术要点。这款社区医生签约管理应用的核心架构遵循React Nat

2401_86113894的博客 394
上一篇: 鸿蒙5.0开发进阶:API ArkUI框架-ArkTS组件(点击回弹效果)
下一篇: 鸿蒙5.0开发进阶:API ArkUI框架-ArkTS组件(动态属性设置)
懂你的大海
博客等级 码龄6年 9049粉丝 1381原创
评论
成就一亿技术人!
拼手气红包6.0元
还能输入1000个字符
 
 条评论被折叠 查看
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付:10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值