输入关键字搜索
开发者能力认证
鸿蒙高校创新赛
HarmonyOS 7
animation
HarmonyOS行业解决方案
layoutWeight
HarmonyOS模板&组件
bindPopup
bindsheet
CTRL+K
文档管理中心
全部文档
指南
API
开放能力API
高级筛选
API version全部版本
设备全部
元服务API集不筛选
您当前正在浏览HarmonyOS最新文档，覆盖已发布的所有API版本，可在API参考中筛选您使用的API版本。详细的版本配套关系请参考版本说明。
开发与测试开放能力API应用框架ArkUI（方舟UI框架）ArkTS组件通用属性动态属性与自定义属性操作工具

属性操作工具

Phone26.0.0+PC/2in126.0.0+Tablet26.0.0+TV26.0.0+Wearable26.0.0+
更新时间: 2026-08-29 09:41
本文导读

ModifierUtils

Phone26.0.0+PC/2in126.0.0+Tablet26.0.0+TV26.0.0+Wearable26.0.0+

ModifierUtils是一个属性修改器工具类，用于提供属性操作的方法。例如，可以判断给定的实例是否为指定组件类型，适用于在统一的AttributeModifier中需要区分不同组件类型并进行差异化属性设置的场景。

起始版本： 26.0.0

元服务API： 从API版本26.0.0开始，该接口支持在元服务中使用。

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

模型约束： 此接口仅可在Stage模型下使用。

isInstanceOf<T extends CommonMethod<T>>

Phone26.0.0+PC/2in126.0.0+Tablet26.0.0+TV26.0.0+Wearable26.0.0+

isInstanceOf<T extends CommonMethod<T>>(instance: T, componentName: string): boolean

检查给定的实例是否为指定组件类型。例如，在自定义属性修改器（AttributeModifier）中为多种组件类型实现统一的属性修改逻辑时，可通过该方法判断当前实例的组件类型，从而对不同组件应用不同的属性设置。

起始版本： 26.0.0

元服务API： 从API版本26.0.0开始，该接口支持在元服务中使用。

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

模型约束： 此接口仅可在Stage模型下使用。

参数：

展开
参数名 类型 必填 说明
instance T 是 要检查的实例，T为继承自通用属性（CommonMethod）的组件属性类型。
componentName string 是 要检查的组件类型名称，取值为组件类名（如 'Text'、'Button' 等），需与组件类名完全一致（区分大小写）。传入无效或不存在的组件类名时返回false。

返回值：

展开
类型 说明
boolean 如果实例是指定的组件类型，则返回true；否则返回false。

示例：

收起
自动换行
深色代码主题
复制
  1. // xxx.ets
  2. // 点击按钮，并检查日志，判断组件是否进入独有分支
  3. import { ModifierUtils } from '@kit.ArkUI';
  4. 

  5. class MyModifier implements AttributeModifier<TextAttribute | ButtonAttribute> {
  6.   isDark: boolean = false;
  7. 

  8.   constructor(dark?: boolean) {
  9.     this.isDark = dark ?? false;
  10.   }
  11. 

  12.   applyNormalAttribute(instance: TextAttribute | ButtonAttribute): void {
  13.     if (ModifierUtils.isInstanceOf(instance, 'Text')) {
  14.       console.info('This is TextAttribute');
  15.       const textInstance = instance as TextAttribute;
  16.       if (this.isDark) {
  17.         textInstance.backgroundColor(Color.Blue);
  18.       } else {
  19.         textInstance.backgroundColor(Color.Green);
  20.       }
  21.     } else if (ModifierUtils.isInstanceOf(instance, 'Button')) {
  22.       console.info('This is ButtonAttribute');
  23.       const buttonInstance = instance as ButtonAttribute;
  24.       if (this.isDark) {
  25.         buttonInstance.type(ButtonType.Circle);
  26.         buttonInstance.backgroundColor(Color.Blue);
  27.       } else {
  28.         buttonInstance.type(ButtonType.Normal);
  29.         buttonInstance.backgroundColor(Color.Green);
  30.       }
  31.     }
  32.   }
  33. }
  34. 

  35. @Entry
  36. @Component
  37. struct MultiComponentAttributeDemo {
  38.   @State myModifier: MyModifier = new MyModifier();
  39. 

  40.   build() {
  41.     Column() {
  42.       Text('Text')
  43.         .fontSize(50)
  44.         .attributeModifier(this.myModifier)
  45.         .onClick(() => {
  46.           this.myModifier.isDark = !this.myModifier.isDark;
  47.         })
  48.       Button('Button')
  49.         .attributeModifier(this.myModifier)
  50.         .onClick(() => {
  51.           this.myModifier.isDark = !this.myModifier.isDark;
  52.         })
  53.     }
  54.     .justifyContent(FlexAlign.SpaceEvenly)
  55.     .width('100%')
  56.     .height('50%')
  57.   }
  58. }
动态SymbolGlyphModifier属性设置
其他
简体中文
华为开发者联盟 版权所有 ©2026
问题反馈
使用条款
华为开发者联盟用户协议
关于华为开发者联盟与隐私的声明
Cookies
开源软件声明
在 开发与测试 开放能力API 中进行搜索
请输入您想要搜索的关键词