鸿蒙5.0开发进阶:ArkTS组件-自定义组件内置方法

鸿蒙5.0版开发:ArkTS组件-自定义组件内置方法 自定义组件内置方法是由ArkUI开发框架提供给应用开发者的,定义在自定义组件基类上的API。 阅读详情

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


自定义组件内置方法

自定义组件内置方法是由ArkUI开发框架提供给应用开发者的,定义在自定义组件基类上的API。应用开发者可以在自定义组件的实例上调用对应的API以获取当前自定义组件实例相关的信息。例如,查询当前自定义组件上下文的UIContext信息。

说明

本模块首批接口从API version 11开始支持,后续版本的新增接口,采用上角标单独标记接口的起始版本。

getUIContext

getUIContext(): UIContext

获取UIContext对象。

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

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

返回值:

类型说明
UIContext返回UIContext实例对象。

示例:

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

@Entry
@Component
struct MyComponent {
  aboutToAppear() {
    let uiContext: UIContext = this.getUIContext();
  }

  build() {
    // ...
  }
}

getUniqueId12+

getUniqueId(): number

获取当前Component的UniqueId。UniqueId为系统为每个组件分配的Id,可保证当前应用中的唯一性。若在组件对应的节点未创建或已销毁时获取,返回无效UniqueId:-1。

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

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

返回值:

类型说明
number返回当前Component的UniqueId。

示例:

@Entry
@Component
struct MyComponent {
  aboutToAppear() {
    let uniqueId: number = this.getUniqueId();
  }

  build() {
    // ...
  }
}

queryNavDestinationInfo

queryNavDestinationInfo(): NavDestinationInfo | undefined;

查询自定义组件所属的NavDestination信息。

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

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

返回值:

类型说明
NavDestinationInfo | undefined返回NavDestinationInfo实例对象。

示例:

import { uiObserver } from '@kit.ArkUI'

@Component
export struct NavDestinationExample {
  build() {
    NavDestination() {
      MyComponent()
    }
  }
}

@Component
struct MyComponent {
  navDesInfo: uiObserver.NavDestinationInfo | undefined

  aboutToAppear() {
    // this指代MyComponent自定义节点,并从该节点向上查找其最近的一个类型为NavDestination的父亲节点
    this.navDesInfo = this.queryNavDestinationInfo();
    console.log('get navDestinationInfo: ' + JSON.stringify(this.navDesInfo))
  }

  build() {
    // ...
  }
}

queryNavigationInfo12+

queryNavigationInfo(): NavigationInfo | undefined

查询自定义组件所属的Navigation信息。

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

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

返回值:

类型说明
NavigationInfo | undefined返回NavigationInfo实例对象。

示例:

// index.ets
import { uiObserver } from '@kit.ArkUI'

@Entry
@Component
struct MainPage {
  pathStack: NavPathStack = new NavPathStack()

  build() {
    Navigation(this.pathStack) {
      // ...
    }.id("NavigationId")
  }
}



@Component
export struct PageOne {
  pathStack: NavPathStack = new NavPathStack()

  aboutToAppear() {
    // this指代PageOne自定义节点,并从该节点向上查找其最近的一个类型为Navigation的父亲节点
    let navigationInfo: uiObserver.NavigationInfo | undefined = this.queryNavigationInfo()
    console.log('get navigationInfo: ' + JSON.stringify(navigationInfo))
    if (navigationInfo !== undefined) {
      this.pathStack = navigationInfo.pathStack
    }
  }

  build() {
    NavDestination() {
      // ...
    }.title('PageOne')
  }
}

queryRouterPageInfo12+

queryRouterPageInfo(): RouterPageInfo | undefined;

获取RouterPageInfo实例对象。

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

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

返回值:

类型说明
RouterPageInfo | undefined返回RouterPageInfo实例对象。

示例:

import { uiObserver } from '@kit.ArkUI'

@Entry
@Component
struct MyComponent {
  aboutToAppear() {
    let info: uiObserver.RouterPageInfo | undefined = this.queryRouterPageInfo();
  }

  build() {
    // ...
  }
}

鸿蒙Harmony应用开发—ArkTS声明式开发(基础手势:LoadingProgress) ArkTS声明式开发(基础手势:LoadingProgress) 阅读详情

相关推荐

鸿蒙5.0版开发:ArkTS容器组件(Refresh)

可以进行页面下拉操作并显示刷新动效的容器组件。

m0_69424697的博客 1433

HarmonyOS(56) 获取自定义组件的唯一ID:getUniqueId()方法

HarmonyOS获取自定义组件的唯一ID,getUniqueId简介

菜鸟博客 902

鸿蒙5.0版开发:ArkTS基础组件(RichEditor)

支持图文混排和文本交互式编辑的组件。

m0_69424697的博客 1925

HarmonyOS--路由管理--组件导航 (Navigation)

HarmonyOS--路由管理--组件导航 (Navigation)

weixin_47808575的博客 3335

鸿蒙5.0版开发:ArkTS组件-LoadingProgress

用于显示加载动效的组件。

m0_69424697的博客 1099

鸿蒙5.0版开发:ArkTS组件-Marquee

跑马灯组件,用于滚动展示一段单行文本。

m0_69424697的博客 1026

ArKTS的基本组件

设置文本的字体粗细,number类型取值[100, 900],取值间隔为100,默认为400,取值越大,字体越粗。string类型仅支持number类型取值的字符串形式,例如“400”,以及“bold”、“bolder”、“lighter”、“regular”、“medium”,分别对应FontWeight中相应的枚举值。当文本内容较多超出了Text组件范围的时候,您可以使用textOverflow设置文本截取方式,需配合maxLines使用,单独设置不生效,maxLines用于设置文本显示最大行数。

morr_的博客 6965

鸿蒙5.0版开发:ArkTS容器组件(TabContent)

仅在Tabs中使用,对应一个切换页签的内容视图。

m0_69424697的博客 1860

鸿蒙应用开发——ArkTS 组件状态管理(一)@State、@Prop、@Link、@Provide和@Consume、@Watch的使用详细教程含示例代码

父组件通过 @State修饰符 定义变量,子组件通过。

m0_73950008的博客 2975

鸿蒙5.0版开发:ArkTS组件-RichText

富文本组件,解析并显示HTML格式文本。

m0_69424697的博客 1231

鸿蒙5.0版开发:ArkTS组件-Search

搜索框组件,适用于浏览器的搜索内容输入框等应用场景。

m0_69424697的博客 1222

HarmonyOS ArkTS Web组件jsbridge

随着智能手机的普及,移动应用的需求日益增长。而在开发移动应用时,前端开发人员需要与原生平台进行交互,以实现更多的功能和优化用户体验。鸿蒙系统提供了一个强大的H5 JSBridge工具,使得前端开发人员可以方便地与鸿蒙系统进行通信和交互。JSBridge是一种将JavaScript代码和原生代码进行桥接的技术。它允许前端开发人员通过JavaScript调用原生代码,实现更多的功能和交互效果。鸿蒙系统的JSBridge提供了一套标准的API,方便开发人员进行调用。

qq_36158551的博客 2654

鸿蒙5.0版开发:ArkTS组件通用属性-自定义绘制设置

自定义组件绘制提供了自定义绘制修改器,来实现更自由地组件绘制。

m0_69424697的博客 1147

(HarmonyOS5.0) 华为鸿蒙开发学习实战教程

《HarmonyOS5.0实战学习指南》摘要 本文介绍了基于HarmonyOS5.0开发"个人健康助手"应用的完整教程。首先详细讲解了开发环境搭建和SDK配置,强调版本兼容性。核心内容包括:基础功能开发(数据展示、目标管理)、HarmonyOS5.0新特性集成(状态管理增强、分布式能力、元服务卡片)以及项目优化测试(性能、兼容性、自动化测试)。教程采用项目驱动方式,通过健康数据同步、多设备协同等场景展示5.0特性应用,并提供了性能优化方案和测试策略。最后总结了开发经验,提出了功能扩展建议

2501_93207838的博客 1580

鸿蒙5.0版开发:ArkTS组件-TabContent

仅在Tabs中使用,对应一个切换页签的内容视图。

m0_69424697的博客 1175

鸿蒙5.0版开发:ArkTS组件-自定义手势判定

为组件提供自定义手势判定能力。

m0_69424697的博客 1100

鸿蒙5.0版开发:ArkTS组件-GridItem

网格容器中单项内容容器。

m0_69424697的博客 1079

鸿蒙5.0开发进阶:自定义装饰器

本示例介绍通过自定义装饰器在自定义组件中自动添加inspector (布局回调)方法并进行调用。

HSMMQAQ的博客 1222
上一篇: 鸿蒙5.0开发进阶:ArkTS组件-自定义组件的自定义布局
下一篇: 鸿蒙5.0开发进阶:ArkTS组件-ForEach
懂你的大海
博客等级 码龄6年 9049粉丝 1381原创
评论
成就一亿技术人!
拼手气红包6.0元
还能输入1000个字符
 
 条评论被折叠 查看
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

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

抵扣说明:

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

余额充值