harmony 鸿蒙ToolBarV2

  • 2025-06-12
  • 浏览 (4)

ToolBarV2

工具栏用于展示针对当前界面内容的操作选项,在界面底部显示。底部最多显示5个入口,超过则收纳入“更多”子项中,在最右侧显示。
该组件基于状态管理V2实现,相较于状态管理V1,状态管理V2增强了对数据对象的深度观察与管理能力,不再局限于组件层级。借助状态管理V2,开发者可以通过该组件更灵活地控制工具栏的数据和状态,实现更高效的用户界面刷新。

说明:

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

  • 该组件不支持在Wearable设备上使用。

导入模块

import { ToolBarV2 } from '@kit.ArkUI';

子组件

ToolBarV2

ToolbarV2({toolBarList: ToolBarV2Item[], activatedIndex?: number, dividerModifier: DividerModifier, toolBarModifier: ToolBarV2Modifier})

工具栏。

装饰器类型:@ComponentV2

原子化服务API: 从API version 18开始,该接口支持在原子化服务中使用。

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

|名称 |类型 |必填|装饰器类型 |说明 | |——————–|—————————————————————-|–|———————|————————————————————–| |toolBarList |ToolBarV2Item[] |是|@Param
@Require|工具栏列表。 | |activatedIndex |number |否|@Param |激活态的子项。

默认值:-1,即无工具栏子项为激活态。
取值范围:[-1,4]。 | |dividerModifier|DividerModifier|否|@Param |工具栏头部分割线属性,可设置分割线高度、颜色等。
默认不生效。 | |toolBarModifier|ToolBarV2Modifier |否|@Param |工具栏属性,可设置工具栏高度、背景色、内边距(仅在工具栏子项数量小于5时生效)、是否显示按压态。
默认不生效。|

ToolBarV2Item

定义工具栏子项。

装饰器类型:@ObservedV2

原子化服务API: 从API version 18开始,该接口支持在原子化服务中使用。

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

属性

|名称 |类型 |必填|装饰器类型|说明 | |—————————-|———————————————–|–|:—–|———————————————————————————————————————————————————————————————————–| |content |ToolBarV2ItemText |是|@Trace|工具栏子项的文本。 | |action |ToolBarV2ItemAction |否|@Trace|工具栏子项点击事件。

默认无点击事件。 | |icon |ToolBarV2ItemIconType|否|@Trace|工具栏子项的图标。
默认不显示图标。 | |state |ToolBarV2ItemState |否|@Trace|工具栏子项的状态。
默认为ENABLE。
| |accessibilityText |ResourceStr |否|@Trace|工具栏子项的无障碍文本属性。当组件不包含文本属性时,屏幕朗读选中此组件时不播报,使用者无法清楚地知道当前选中了什么组件。为了解决此场景,开发人员可为不包含文字信息的组件设置无障碍文本,当屏幕朗读选中此组件时播报无障碍文本的内容,帮助屏幕朗读的使用者清楚地知道自己选中了什么组件。
默认值为当前项content属性内容。 | |accessibilityDescription|ResourceStr |否|@Trace|工具栏子项的无障碍描述。此描述用于向用户详细解释当前组件,开发人员应为组件的这一属性提供较为详尽的文本说明,以协助用户理解即将执行的操作及其可能产生的后果。特别是当这些后果无法仅从组件的属性和无障碍文本中直接获知时。如果组件同时具备文本属性和无障碍说明属性,当组件被选中时,系统将首先播报组件的文本属性,随后播报无障碍说明属性的内容。
默认值:“单指双击即可执行”。 | |accessibilityLevel|string |否|@Trace|工具栏子项无障碍重要性。用于控制当前项是否可被无障碍辅助服务所识别。