鸿蒙5.0开发进阶:UI框架-ArkTS组件(TreeView)

鸿蒙OpenHarmony【TreeView】信息展示 树视图作为一种分层显示的列表,适合显示嵌套结构。拥有父列表项和子列表项,可展开或折叠。 用于效率型应用,如备忘录、电子邮件、图库中的侧边导航栏中。 阅读详情

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


TreeView

树视图作为一种分层显示的列表,适合显示嵌套结构。拥有父列表项和子列表项,可展开或折叠。

用于效率型应用,如备忘录、电子邮件、图库中的侧边导航栏中。

说明

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

导入模块

import { TreeView } from "@kit.ArkUI"

子组件

无

属性

不支持通用属性。

TreeView

TreeView({ treeController: TreeController })

装饰器类型:@Component

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

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

参数:

名称参数类型必填说明
treeControllerTreeController是树视图节点信息。

TreeController

树视图组件的控制器,可以将此对象绑定至树视图组件,然后通过它控制树的节点信息,同一个控制器不可以控制多个树视图组件。

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

addNode

addNode(nodeParam?: NodeParam): void

点击某个节点后,调用该方法可以触发新增孩子节点。

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

参数:

名称参数类型必填说明
nodeParamNodeParam否节点信息。

removeNode

removeNode(): void

点击某个节点后,调用该方法可以触发删除该节点。

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

modifyNode

modifyNode(): void

点击某个节点后,调用该方法可以触发修改该节点。

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

buildDone

buildDone(): void

建立树视图。节点增加完毕后,必须调用该方法,触发树信息的保存。

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

refreshNode

refreshNode(parentId: number, parentSubTitle: ResourceStr, currentSubtitle: ResourceStr): void

更新树视图。调用该方法,更新当前节点的信息。

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

参数:

名称参数类型必填说明
parentIdnumber是父节点Id。
parentSubTitleResourceStr是父节点副文本。
currentSubtitleResourceStr是当前节点副文本。

NodeParam

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

名称类型必填说明
parentNodeIdnumber否父节点。
currentNodeIdnumber否当前子节点。
isFolderboolean否是否是目录。默认值:false。true:是目录,false:不是目录。
iconResourceStr否图标。
selectedIconResourceStr否选中图标。
editIconResourceStr否编辑图标。
primaryTitleResourceStr否主标题。
secondaryTitleResourceStr否副标题。
container() => void否绑定在节点上的右键子组件,子组件由@Builder修饰。

TreeListenerManager

树视图组件的监听器,可以将此对象绑定至树视图组件,然后通过它监听树的节点的变化,同一个监听器不可以控制多个树视图组件。

getInstance

static getInstance(): TreeListenerManager

获取监听管理器单例对象。

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

返回值:

类型说明
TreeListenerManager返回获取到的监听管理器单例对象。

getTreeListener

getTreeListener(): TreeListener

获取监听器。

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

返回值:

类型说明
TreeListener返回获取到的监听器。

TreeListener

树视图组件的监听器,可以将此对象绑定至树视图组件,然后通过它监听树的节点的变化,同一个监听器不可以控制多个树视图组件。

on

on(type: TreeListenType, callback: (callbackParam: CallbackParam) => void): void;

注册监听。

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

参数:

名称参数类型必填说明
typeTreeListenType是监听类型。
callback(callbackParam: CallbackParam) => void是节点信息。

once

once(type: TreeListenType, callback: (callbackParam: CallbackParam) => void): void;

注册一次监听。

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

参数:

名称参数类型必填说明
typeTreeListenType是监听类型。
callback(callbackParam: CallbackParam) => void是节点信息。

off

off(type: TreeListenType, callback?: (callbackParam: CallbackParam) => void): void;

取消监听。

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

参数:

名称参数类型必填说明
typeTreeListenType是监听类型。
callback(callbackParam: CallbackParam) => void否节点信息。

TreeListenType

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

名称说明
NODE_CLICK监听节点点击事件。
NODE_ADD监听节点增加事件。
NODE_DELETE监听节点删除事件。
NODE_MODIFY监听节点修改事件。
NODE_MOVE监听节点移动事件。

CallbackParam

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

名称类型必填说明
currentNodeIdnumber是当前子节点。
parentNodeIdnumber否父节点。
childIndexnumber否子索引。

事件

不支持通用事件。

示例

通过树视图组件的控制器对树的节点进行新增、删除、重命名,展示新增不同参数节点的实现效果。

import { TreeController, TreeListener, TreeListenerManager, TreeListenType, NodeParam, TreeView, CallbackParam } from '@kit.ArkUI'

@Entry
@Component
struct TreeViewDemo {
  private treeController: TreeController = new TreeController();
  private treeListener: TreeListener = TreeListenerManager.getInstance().getTreeListener();
  @State clickNodeId: number = 0;

  aboutToDisappear(): void {
    this.treeListener.off(TreeListenType.NODE_CLICK, undefined);
    this.treeListener.off(TreeListenType.NODE_ADD, undefined);
    this.treeListener.off(TreeListenType.NODE_DELETE, undefined);
    this.treeListener.off(TreeListenType.NODE_MOVE, undefined);
  }

  @Builder menuBuilder1() {
    Flex({ direction: FlexDirection.Column, justifyContent: FlexAlign.Center, alignItems: ItemAlign.Center }) {
      Text('新增').fontSize(16).width(100).height(30).textAlign(TextAlign.Center)
        .onClick((event: ClickEvent) => {
          this.treeController.addNode();
        })
      Divider()
      Text('删除').fontSize(16).width(100).height(30).textAlign(TextAlign.Center)
        .onClick((event: ClickEvent) => {
          this.treeController.removeNode();
        })
      Divider()
      Text('重命名').fontSize(16).width(100).height(30).textAlign(TextAlign.Center)
        .onClick((event: ClickEvent) => {
          this.treeController.modifyNode();
        })
    }.width(100).border({width: 1, color: 0x80808a, radius: '16dp'})
  }

  aboutToAppear(): void {
    this.treeListener.on(TreeListenType.NODE_CLICK, (callbackParam: CallbackParam) => {
      this.clickNodeId = callbackParam.currentNodeId;
    })
    this.treeListener.on(TreeListenType.NODE_ADD, (callbackParam: CallbackParam) => {
      this.clickNodeId = callbackParam.currentNodeId;
    })
    this.treeListener.on(TreeListenType.NODE_DELETE, (callbackParam: CallbackParam) => {
      this.clickNodeId = callbackParam.currentNodeId;
    })
    this.treeListener.once(TreeListenType.NODE_MOVE, (callbackParam: CallbackParam) => {
      this.clickNodeId = callbackParam.currentNodeId;
    })

    let normalResource: Resource = $r('app.media.ic_public_collect_normal');
    let selectedResource: Resource = $r('app.media.ic_public_collect_selected');
    let editResource: Resource = $r('app.media.ic_public_collect_edit');
    let nodeParam: NodeParam = { parentNodeId:-1, currentNodeId: 1, isFolder: true, icon: normalResource, selectedIcon: selectedResource,
      editIcon: editResource, primaryTitle: "目录1验证悬浮框自适应效果是否OK",
      secondaryTitle: "6" };
    this.treeController
      .addNode(nodeParam)
      .addNode({parentNodeId:1, currentNodeId: 2, isFolder: false, primaryTitle: "项目1_1" })
      .addNode({ parentNodeId:-1, currentNodeId: 7, isFolder: true, primaryTitle: "目录2" })
      .addNode({ parentNodeId:-1, currentNodeId: 23, isFolder: true, icon: normalResource, selectedIcon: selectedResource,
        editIcon: editResource, primaryTitle: "目录3" })
      .addNode({ parentNodeId:-1, currentNodeId: 24, isFolder: false, primaryTitle: "项目4" })
      .addNode({ parentNodeId:-1, currentNodeId: 31, isFolder: true, icon: normalResource, selectedIcon: selectedResource,
        editIcon: editResource, primaryTitle: "目录5", secondaryTitle: "0" })
      .addNode({ parentNodeId:-1, currentNodeId: 32, isFolder: true, icon: normalResource, selectedIcon: selectedResource,
        editIcon: editResource, primaryTitle: "目录6", secondaryTitle: "0" })
      .addNode({ parentNodeId:32, currentNodeId: 35, isFolder: true, icon: normalResource, selectedIcon: selectedResource,
        editIcon: editResource, primaryTitle: "目录6-1", secondaryTitle: "0" })
      .addNode({ parentNodeId:-1, currentNodeId: 33, isFolder: true, icon: normalResource, selectedIcon: selectedResource,
        editIcon: editResource, primaryTitle: "目录7", secondaryTitle: "0" })
      .addNode({ parentNodeId:33, currentNodeId: 34, isFolder: false, primaryTitle: "项目8" })
      .addNode({ parentNodeId:-1, currentNodeId: 36, isFolder: false, primaryTitle: "项目9" })
      .buildDone();
    this.treeController.refreshNode(-1, "父节点", "子节点");
  }

  build() {
    Column(){
      SideBarContainer(SideBarContainerType.Embed)
      {
        TreeView({ treeController: this.treeController })
        Row() {
          Divider().vertical(true).strokeWidth(2).color(0x000000).lineCap(LineCapStyle.Round)
          Column({ space: 30 }) {
            Text('ClickNodeId=' + this.clickNodeId).fontSize('16fp')
            Button('Add', { type: ButtonType.Normal, stateEffect: true })
              .borderRadius(8).backgroundColor(0x317aff).width(90)
              .onClick((event: ClickEvent) => {
                this.treeController.addNode();
              })
            Button('Modify', { type: ButtonType.Normal, stateEffect: true })
              .borderRadius(8).backgroundColor(0x317aff).width(90)
              .onClick((event: ClickEvent) => {
                this.treeController.modifyNode();
              })
            Button('Remove', { type: ButtonType.Normal, stateEffect: true })
              .borderRadius(8).backgroundColor(0x317aff).width(120)
              .onClick((event: ClickEvent) => {
                this.treeController.removeNode();
              })
          }.height('100%').width('70%').alignItems(HorizontalAlign.Start).margin(10)
        }
      }
      .focusable(true)
      .showControlButton(false)
      .showSideBar(true)
    }
  }}

鸿蒙5.0版开发:ArkTS组件-TreeView 树视图作为一种分层显示的列表,适合显示嵌套结构。 阅读详情

相关推荐

HarmonyOS实战开发-深度探索与打造个性化自定义组件

今天分享一下 什么是自定义组件?及其自定义组件的实战。

m0_70749039的博客 858

#跟着若城学鸿蒙# UI组件篇-TreeView及其属性

ArkUI中的TreeView组件提供了一种分层显示列表的方式,适用于展示嵌套结构的数据。通过TreeController和TreeListenerManager,开发者可以方便地控制和管理树的节点,实现新增、删除、修改和移动节点的操作。TreeView组件的灵活性和可扩展性使其成为开发复杂UI界面的有力工具。----以上。

Huang兄 906

在鸿蒙ArkTS中使用Three.js实现3D模型渲染

Three.js是一个流行的JavaScript 3D库,它简化了WebGL的使用,使得创建3D图形变得更加容易。通过将Three.js与ArkTS结合,我们可以在鸿蒙应用中实现高质量的3D模型渲染,为用户提供更加丰富和交互的体验。然而,在复杂的3D图形渲染方面,ArkTS还缺乏原生的支持。在本文中,我们将探讨如何在鸿蒙ArkTS应用中集成Three.js,实现3D模型的加载、渲染和交互。c) 安装依赖: 由于Three.js是一个JavaScript库,我们需要一种方法在ArkTS中使用它。

况老师话竞赛&blog 1383

html5 tree view css,一个TreeView 样式表

定义样式表1 HTML标记定义...`1、多个属性必须要用;分开·2、background-p_w_picpath:url(:/new/prefix1/p_w_picpaths/icon_num_1.png);设置背景图片background-position:center设置背景图片居中显...1.样式复用,方便网站的后期维护; 2.实现页面的精确控制,实现精美...

weixin_39882948的博客 1028

鸿蒙NEXT开发【Web场景性能优化指导】性能

ArkWeb(方舟Web)是一个Web组件平台,旨在为应用程序提供展示Web页面内容的功能,并为开发者提供丰富的能力,包括页面加载、页面交互、页面调试等功能。在这个数字化时代,页面显示的速度直接体现了应用的流畅性,影响着用户对应用的印象和体验。快速加载并展示页面不仅可以吸引用户留在应用上,还能减少他们的等待时间和不耐烦情绪,从而提升用户的满意度。

ADgai1987的博客 1752

鸿蒙NEXT开发ArkUI【ComponentContent】 UI界面

ComponentContent表示组件内容的实体封装,其对象支持在非UI组件中创建与传递,便于开发者对弹窗类组件进行解耦封装。ComponentContent底层使用了BuilderNode

CS9527DND的博客 1324

鸿蒙开发-组件初体验

鸿蒙开发-组件简介+组件初体验+组件关系+组件状态共享

唯见青山不见君 1513

HarmonyOS NEXT实战开发:自定义节点(BuilderNode)

对于使用自定义节点的能力进行对接的三方框架,BuilderNode为其提供了嵌入原生组件的能力。

2401_87288236的博客 1383

HarmonyOS开发实战( Beta5版)Web组件开发性能提升指导

用户在使用Web组件显示网页时往往会经历四个阶段:无反馈-->白屏-->网页渲染-->完全展示,系统会在各个阶段内分别进行WebView初始化、建立网络连接、接受数据与渲染页面等操作,如图一所示是WebView的启动阶段。

weixin_55362248的博客 2361

鸿蒙NEXT开发【声明式UI中实现组件动态创建】应用框架开发

为了解决页面、组件加载缓慢的问题,ArkUI框架提供了动态操作以实现组件预创建,并允许应用在运行时根据实际需要加载渲染相应的组件。动态操作包含动态创建组件(动态添加组件)、动态卸载组件(动态删除组件)等相关操作。动态创建组件指在非build生命周期中进行组件创建,即在build生命周期前提前创建组件。通过动态创建组件,不但可以节省组件创建的时间,提升用户体验,还可以将独立的逻辑进行封装,有助于应用模块化开发。动态卸载组件是对动态创建的组件进行卸载、删除。

houxiliOH的博客 1349

HarmonyOS Next 实现多级树型列表选择器

开发ERP系统的时候经常会用到部门树列表,页面主要由搜索框、顶部部门面包屑、多层级部门列表组成,部门列表项由不么名称和下一级右边箭头组成,点击部门名称区域可以回传部门数据到上一个页面,点击下一级箭头按钮可以展示下一级部门列表,同时将父级部门添加到顶部面包屑。

cj641809386的专栏 870

ArkTS开发实践

ArkTS通过struct声明组件名,并通过@Component和@Entry装饰器,来构成一个自定义组件。使用@Entry和@Component装饰的自定义组件作为页面的入口,会在页面加载时首先进行渲染。@Entry@Component例如ToDoList组件对应如下整个代办页面。图1ToDoList待办列表使用@Component装饰的自定义组件,如ToDoItem这个自定义组件则对应如下内容,作为页面的组成部分。@Component图2ToDoItem。

wu347771769的专栏 305

HarmonyOS Next开发学习手册——同层渲染绘制Video和Button组件

开发者也可通过 registerNativeEmbedRule(tag: string, type: string) 指定tag标签和自定义类型。当前tag仅支持"embed"和"object",type类型则可任意指定,两个字符串参数均不区分大小写,ArkWeb内核侧将会统一转成小写,其中tag字串使用全字符串匹配,type使用字符串前缀匹配。

maniuT的博客 1271

鸿蒙API13开发【NodeController】UI界面API

NodeController用于实现自定义节点的创建、显示、更新等操作的管理,并负责将自定义节点挂载到[NodeContainer]上。

鸿蒙的技术博客 1272

鸿蒙NEXT开发【@ohos.arkui.node】 UI界面API

Node将自定义节点的二级模块API组织在一起,方便开发者进行导出使用。

CS9527DND的博客 576

HarmonyOS NEXT实战开发:自定义占位节点

ArkUI提供了ArkTS原生组件作为自定义节点的占位节点。该占位节点具备组件的通用属性。

hanyanyou的博客 1104

鸿蒙实战开发-如何通过enableNativeEmbedMode()控制同层渲染开关。

开发者可通过enableNativeEmbedMode()控制同层渲染开关。Html文件中需要显式使用embed标签,并且embed标签内type必须以“native/”开头。

2401_82546228的博客 481

地图坐标系大全:常用地图坐标系详解与转换指南

地图坐标系是用于描述地图上位置的数学模型。它可以用来表示地球表面上的任意一个点,使得这个点的位置可以在地图上精确定位。不同的地图坐标系采用不同的基准面和投影方式,因此会有不同的坐标系参数,不同的坐标系之间也需要进行坐标转换。在地图制图、导航、GIS等领域中,地图坐标系是一个非常重要的概念。

weixin_39888010的博客 1万+

HarmonyOS API 26 Navigation路由栈上限:stackSizeLimit、过载保护与容量观测

解析API 26 NavigationConfiguration.stackSizeLimit的活跃页面节点限制,并用入口节流、容量水位、降级策略和纯函数测试治理深栈风险。

2401_84996024的博客 350

天祥TX-1C单片机开发板-秒表程序

郭天祥TX-1C开发板实现秒表程序 附开发板图片和原理图 代码 #include <reg52.h> sbit key1=P3^4; //按键S2 sbit key2=P3^5; //按键S3 sbit U1=P2^6; //LED位选 sbit U2=P2^7; //LED片选 unsigned char code ledchar[]={ /...

Run_long_road 3515

全网首发!Yolov8_obb旋转框训练、测试、推理手把手教学(DOTA1.0数据集map50已达80%)

其中,images/train和images/val放置原始图片文件,labels/train_original和labels/val_original分别放置原始的标签文件,labels/train和labels/val为空,然后运行步骤(3)的代码,运行结束转换后的标签会保存在labels/train和labels/val中,格式如下。(4)新建yolov8-obb.yaml,修改nc和scales,我使用的是yolov8n.(2)构建数据集,安装下面目录格式,其他test可为空,一定要对应。

小嘤熊的博客 2万+
上一篇: 鸿蒙5.0开发进阶:UI框架-ArkTS组件(TextTimer)
下一篇: 鸿蒙5.0开发进阶:UI框架-ArkTS组件(Blank)
懂你的大海
博客等级 码龄6年 9049粉丝 1381原创
评论
成就一亿技术人!
拼手气红包6.0元
还能输入1000个字符
 
 条评论被折叠 查看
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

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

抵扣说明:

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

余额充值