logo
积分中心
鸿蒙UI开发——attributeModifier动态属性
头像 蓝亭书序 2026-11-18 14:41:46    发布
544 浏览 0 收藏

1、概 述

鸿蒙UI开发快速入门 —— part05:组件的样式复用

  • focused:获焦态。
  • normal:正常态。
  • pressed:按压态。
  • disabled:不可用态。

示例代码如下(8、11、14行):


@Entry
@Component
struct StateStylesSample {
  build() {
    Column() {
      Button('Button1')
        .stateStyles({
          focused: {
            .backgroundColor(Color.Pink)
          },
          pressed: {
            .backgroundColor(Color.Black)
          },
          normal: {
            .backgroundColor(Color.Red)
          }
        })
    }.margin('30%')
  }
}


但实际业务开发中,我们的状态可能会有一些if/else等复杂的状态判断,为了满足复杂逻辑的多态样式设置需要,我们可以通过attributeModifier属性来完成,本文针对attributeModifier的使用做简答讨论。

先上效果:我们实现一个按钮,用户按下时背景颜色在橙色和绿色之间随机,示意如下(文末有源代码):

图片

2、attributeModifier接口定义

attributeModifier属性的使用定义如下:


attributeModifier(modifier: AttributeModifier<T>)


使用方法与其他属性定义类似,示例如下(第二行):


Text('欢迎加入【Harmony自习室】')
  .attributeModifier(this.modifier)


其中,attributeModifier属性设置的核心在于入参modifier,它是一个AttributeModifier<T>类型的对象,需要我们自定义实现。

AttributeModifier<T>接口定义如下:


interface AttributeModifier<T> {
    // 组件普通状态下的样式
    applyNormalAttribute?(instance: T): void;
    // 组件按下状态时的样式
    applyPressedAttribute?(instance: T): void;
    // 组件获取焦点时的样式
    applyFocusedAttribute?(instance: T): void;
    // 组件禁用状态时的样式
    applyDisabledAttribute?(instance: T): void;
    // 组件选中状态时的样式
    applySelectedAttribute?(instance: T): void;
}


方法中的instance入参是:组件的属性类,用来标识进行属性设置的组件的类型,比如Button组件的ButtonAttribute,Text组件的TextAttribute等。

目前支持的类型如下(常用的内置组件都支持,本文章将以TextAttribute为例):

AlphabetIndexerAttribute、BadgeAttribute、BlankAttribute、ButtonAttribute、CalendarPickerAttribute、CanvasAttribute、CheckboxAttribute、CheckboxGroupAttribute、CircleAttribute、ColumnAttribute、ColumnSplitAttribute、ShapeAttribute、CommonAttribute、CounterAttribute、DataPanelAttribute、DatePickerAttribute、DividerAttribute、EllipseAttribute、FlexAttribute、FlowItemAttribute、FormLinkAttribute、GaugeAttribute、GridAttribute、GridColAttribute、ColumnAttribute、GridItemAttribute、GridRowAttribute、HyperlinkAttribute、ImageAttribute、ImageAnimatorAttribute、ImageSpanAttribute、LineAttribute、ListAttribute、ListItemAttribute、ListItemGroupAttribute、LoadingProgressAttribute、MarqueeAttribute、MenuAttribute、MenuItemAttribute、MenuItemGroupAttribute、NavDestinationAttribute、NavigationAttribute、NavigatorAttribute、NavRouterAttribute、PanelAttribute、PathAttribute、PatternLockAttribute、PolygonAttribute、PolylineAttribute、ProgressAttribute、QRCodeAttribute、RadioAttribute、RatingAttribute、RectAttribute、RefreshAttribute、RelativeContainerAttribute、RichEditorAttribute、RichTextAttribute、RowAttribute、RowSplitAttribute、ScrollAttribute、ScrollBarAttribute、SearchAttribute、SelectAttribute、ShapeAttribute、SideBarContainerAttribute、SliderAttribute、SpanAttribute、StackAttribute、StepperAttribute、StepperItemAttribute、SwiperAttribute、SymbolGlyphAttribute、TabContentAttribute、TabsAttribute、TextAttribute、TextAreaAttribute、TextClockAttribute、TextInputAttribute、TextPickerAttribute、TextTimerAttribute、TimePickerAttribute、ToggleAttribute、VideoAttribute、WaterFlowAttribute、XComponentAttribute、ParticleAttribute。

另外需要注意:

instance参数的属性设置不支持入参为CustomBuilder或Lamda表达式的属性,且不支持手势,事件仅支持onClick、onTouch、onAppear、onDisAppear、onMouse、onHover、onKeyEvent、onBlur、onFocus、onAreaChange、onSizeChange、onGestureJudgeBegin、onGestureRecognizerJudgeBegin、shouldBuiltInRecognizerParallelWith。不支持已废弃属性,未支持的属性在使用时会抛异常"Method not implemented"。

3、示 例

我们以开篇说到的效果为例:实现一个按钮,用户按下时背景颜色在橙色和绿色之间随机,效果如下:

图片

代码如下(1 ~ 10行、19行):


class MyModifier implements AttributeModifier<TextAttribute> {
  applyNormalAttribute(instance: TextAttribute): void {
    instance.backgroundColor(Color.Pink);
    instance.fontColor(Color.Black);
  }
  applyPressedAttribute(instance: TextAttribute): void {
    instance.backgroundColor(Math.random() * 10 > 5 ? Color.Green : Color.Orange);
    instance.fontColor(Color.White);
  }
}
@Entry
@Component
struct attributePressedDemo {
  @State modifier: MyModifier = new MyModifier()
  build() {
    Row() {
      Column() {
        Text('欢迎加入【Harmony自习室】')
          .attributeModifier(this.modifier)
          .borderRadius(20)
          .padding(20)
          .animation({ duration: 500 })
      }
      .width('100%')
    }
    .height('100%')
  }
}



4、one more thing

我们还可以实现自定义的Modifier,使用自定义Modifier构建组件并配置属性,通过此自定义的Modifier可调用所封装组件的属性和样式接口。

自定义Modifier支持范围如下:

CommonModifier、ColumnModifier、ColumnSplitModifier、RowModifier、RowSplitModifier、SideBarContainerModifier、BlankModifier、DividerModifier、GridColModifier、GridRowModifier、NavDestinationModifier、NavigatorModifier、StackModifier、NavigationModifier、NavRouterModifier、StepperItemModifier、TabsModifier、GridModifier、GridItemModifier、ListModifier、ListItemModifier、ListItemGroupModifier、ScrollModifier、SwiperModifier、WaterFlowModifier、ButtonModifier、CounterModifier、TextPickerModifier、TimePickerModifier、ToggleModifier、CalendarPickerModifier、CheckboxModifier、CheckboxGroupModifier、DatePickerModifier、RadioModifier、RatingModifier、SelectModifier、SliderModifier、PatternLockModifier、SpanModifier、RichEditorModifier、RefreshModifier、SearchModifier、TextAreaModifier、TextModifier、TextInputModifier、ImageSpanModifier、ImageAnimatorModifier、ImageModifier、VideoModifier、DataPanelModifier、GaugeModifier、LoadingProgressModifier、MarqueeModifier、ProgressModifier、QRCodeModifier、TextClockModifier、TextTimerModifier、LineModifier、PathModifier、PolygonModifier、PolylineModifier、RectModifier、ShapeModifier、AlphabetIndexerModifier、FormComponentModifier、HyperlinkModifier、MenuModifier、MenuItemModifier、PanelModifier、SymbolGlyphModifier、ParticleModifier。

未暴露的组件Modifier可以使用CommonModifier。


我们实现一个效果如下,用户可以点击按钮在两种样式间切换:

图片

代码如下(1 ~ 20行、 31 ~ 38行):


import { CommonModifier } from "@kit.ArkUI"
class MyModifier extends CommonModifier {
  applyNormalAttribute(instance: CommonAttribute): void {
    super.applyNormalAttribute?.(instance);
    // 设置默认样式 
    instance.backgroundColor(Color.Orange);
    instance.borderRadius(20);
    instance.padding(20);
    instance.borderWidth(3);
    this.setStyle1();
  }

  // 定义两个方法,实现两个样式间的设置
  public setStyle1(): void {
    this.borderStyle(BorderStyle.Dotted)
  }
  public setStyle2(): void {
    this.borderStyle(BorderStyle.Dashed)
  }
}
@Entry
@Component
struct Index {
  @State myModifier: MyModifier = new MyModifier();
  index: number = 0;
  build() {
    Column() {
      Button('点击切换')
        .margin(10)
        .onClick(() => {
          this.index = (++this.index) % 2;
          if (this.index) {
            this.myModifier.setStyle2()
          } else {
            this.myModifier.setStyle1()
          }
        })
      Text('欢迎加入【Harmony自习室】').attributeModifier(this.myModifier as MyModifier)
    }
    .width('100%')
  }
}




©本站发布的所有内容,包括但不限于文字、图片、音频、视频、图表、标志、标识、广告、商标、商号、域名、软件、程序等,除特别标明外,均来源于网络或用户投稿,版权归原作者或原出处所有。我们致力于保护原作者版权,若涉及版权问题,请及时联系我们进行处理。
分类
HarmonyOS

暂无评论数据

加载中...

发布

地址:北京市朝阳区北三环东路三元桥曙光西里甲1号第三置业A座1508室 电话:13391790444或(010)62178877
版权所有:电脑商情信息服务集团 北京赢邦策略咨询有限责任公司
声明:本媒体部分图片、文章来源于网络,版权归原作者所有,我司致力于保护作者版权,如有侵权,请与我司联系删除

京ICP备:2022009079号-2

京公网安备:11010502051901号

ICP证:京B2-20230255