蓝亭书序
2026-11-18 14:41:46 发布1、概 述
- 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%')
}
}暂无评论数据
发布
相关推荐
蓝亭书序
66
0
蓝亭书序
44
0
蓝亭书序
412
0
蓝亭书序
42
0
蓝亭书序
58
0
蓝亭书序
我还没有写个人简介......
帖子
提问
粉丝
鸿蒙开发——实现活体检测
2026-11-18 14:47:48 发布鸿蒙开发——通用AI识图控件
2026-11-18 14:46:24 发布



京公网安备:11010502051901号