建议采用AttributeUpdater方法自定义框架,具体实现如下:
export class ExListModify extends AttributeUpdater<ListModifier> {
private exScrollBar: BarState = BarState.Off;
private exConstrainSize: ConstraintSizeOptions = { maxHeight: '100%' };
initializeModifier(instance: ListAttribute): void {
instance.scrollBar(this.exScrollBar)
.constraintSize(this.exConstrainSize)
.edgeEffect(EdgeEffect.None)
.layoutWeight(1);
}
};
@Component
export struct ExList {
@BuilderParam bindView: () => void;
attribute: ExListModify = new ExListModify();
scroller: Scroller = new Scroller();
@Prop space: string | number | undefined = undefined;
@Prop initialIndex?: number = undefined;
build() {
List({ scroller: this.scroller, space: this.space, initialIndex: this.initialIndex }) {
this.bindView();
}.attributeModifier(this.attribute); // AttributeModifier方法调用封装好的修饰类ExListModify
}
}
ExList({ attribute: this.modify }) {
ForEach(this.dataList1, (item: number) => {
ListItem() {
Text('列表项目' + item.toString()).width('100%').height(44).textAlign(TextAlign.Center);
};
});
};
完整示例参考如下:
import { AttributeUpdater, ListModifier } from '@kit.ArkUI';
// 初始化并配置列表属性对象
export class ExListModify extends AttributeUpdater<ListModifier> {
private exScrollBar: BarState = BarState.Off;
private exConstrainSize: ConstraintSizeOptions = { maxHeight: '100%' };
initializeModifier(instance: ListAttribute): void {
instance.scrollBar(this.exScrollBar)
.constraintSize(this.exConstrainSize)
.edgeEffect(EdgeEffect.None)
.layoutWeight(1);
}
};
// 自定义列表组件ExList
@Component
export struct ExList {
@BuilderParam bindView: () => void;
attribute: ExListModify = new ExListModify();
scroller: Scroller = new Scroller();
@Prop space: string | number | undefined = undefined;
@Prop initialIndex?: number = undefined;
build() {
List({ scroller: this.scroller, space: this.space, initialIndex: this.initialIndex }) {
this.bindView();
}.attributeModifier(this.attribute); // AttributeModifier方法调用封装好的修饰类ExListModify
}
}
@Entry
@Component
export struct CustomUiDemo {
dataList1: number[] =
[1, 2, 3, 4, 5, 6, 1, 2, 3, 4, 5, 6, 1, 2, 3, 4, 5, 6, 1, 2, 3, 4, 5, 6, 1, 2, 3, 4, 5, 6, 1, 2, 3, 4, 5, 6, 1, 2,
3, 4, 5, 6, 1, 2, 3, 4, 5, 6, 1, 2, 3, 4, 5, 6, 1, 2, 3, 4, 5, 6, 1, 2, 3, 4, 5, 6, 1, 2];
dataList2: number[] =
[23, 213, 213, 123, 21312, 421, 3123, 123, 124, 123, 124, 3512, 3512, 4324234, 12312, 213, 123, 12, 312, 321, 3,
123, 124, 124, 234];
dataType: number = 1;
listScroller = new Scroller();
modify: ExListModify = new ExListModify();
build() {
Column() {
Button('点击更换列表').onClick(() => {
this.modify.attribute?.backgroundColor('#0A59f7');
this.modify.attribute?.scrollBar(BarState.On);
});
Blank().height(10);
Button('点击增加').onClick(() => {
this.modify.attribute?.scrollBar(BarState.Off);
this.modify.attribute?.edgeEffect(EdgeEffect.Spring);
});
Blank().height(10);
// 组件ExList展示相关数据
ExList({ attribute: this.modify }) {
ForEach(this.dataList1, (item: number) => {
ListItem() {
Text('列表项目' + item.toString()).width('100%').height(44).textAlign(TextAlign.Center);
};
});
};
}
.width('100%')
.height('100%');
}
}
效果预览:

Q:在构建页面时,去使用不同的Text组件替代List组件,这种情况下,构建几个Text组件就要创建几个Modifier,页面比较复杂时就可能要创建过多的Modifier,如何处理这种散装字段的数据源?
A:可以使用统一风格封装全局动态属性,专有特性方面可以自定义设置。
Q:可以使用AttributeModifier方法来实现自定义UI吗?TextModifier呢?
A:使用AttributeModifier实现的自定义UI不能在其中设置所有属性,会出现达不到预期效果的情况,而TextModifier实现的自定义UI包含所有属性,但是其不支持自定义Modifier感知@State装饰的数据的变化,无法进行数据变更。
Q:自定义组件不支持设置AttributeModifier吗?
A:从API version 20开始,AttributeModifier支持自定义组件。