目录

如何解决attributeModifier常见报错问题

问题现象

使用attributeModifier时程序崩溃,报以下几种错误:

背景知识

ArkUI支持动态属性设置,可通过组件的通用方法attributeModifier设置组件的多态样式,在使用此方法时,开发者需要自定义class实现attributeModifier接口。

注意:在attributeModifier中设置的属性尽量不要与其他方法设置的属性相同,避免在页面刷新时attributeModifier不生效。

组件的部分属性不支持在attributeModifier中设置:

解决方案

完整代码如下:

@Entry
@Component
struct AttributeModifierDemo {
  build() {
    Column() {
      SceneOne();
      SceneTwo();
    };
  }
}


@Component
struct SceneOne {
  build() {
    Navigation() {
    }
    .title({ builder: mainToolbarLayout(), height: 60 })
    .height('100%')
    .width('100%');
  }
}


@Component
struct SceneTwo {
  build() {
    Text('hello world')
      .textExt();
  }
}


@Extend(Text)
function textExt() {
  .bindSelectionMenu(TextSpanType.TEXT, longPressEmptyMenu, TextResponseType.LONG_PRESS);
}


@Builder
function mainToolbarLayout() {
  Row() {
    Text('ceshi');
    Blank();
    Image($r('app.media.startIcon'))
      .width(20)
      .height(20)
      .objectFit(ImageFit.Contain);
  }.padding({ left: 12, right: 12 })
  .height('100%').width('100%');
}


@Builder
function longPressEmptyMenu() {
  // 需要让Menu组件为空,才能达到长按选中但不出现默认菜单的效果
  Column() {
    Menu() {
    };
  };
}

常见FAQ

Q:上述场景二这种需要封装自定义组件给多个地方使用,attributeModifier不支持bindSelectionMenu属性,应该如何从外部指定呢?

A:使用@Extend封装bindSelectionMenu属性在当前文件内作为公共组件使用,但不支持export导出在其它文件中使用,若是跨文件使用则需重新定义。

Q:设置HdsNavigation的titleBar时,入参中没有填入CustomBuilder,也会报错“undefined is not callable”,为什么?

A:HdsNavigation的titleBar中包含了类型为CustomBuilder的可选参数,因此不支持在动态属性中使用,即使使用过程中没有填入CustomBuilder也会有相应报错。

Q:在API19环境下,attributeModifier使用onVisibleAreaChange属性导致闪退,报错Method not implemented。

A:报错Method not implemented,说明该属性当前不支持attributeModifier。从API20开始,onVisibleAreaChange该接口支持在attributeModifier中调用。

总结

在使用attributeModifier遇错时,可以按照以下步骤排查:

  1. 检查Attribute是否可以使用attributeModifier封装。详细可查阅applySelectedAttribute文档下方描述的instance参数支持范围。
  2. 判断是否使用了不支持或者未实现的属性。详细可查阅属性或事件对attributeModifier的支持情况。
  3. 对于不在2中所列举,但是报错的属性,可以查看此属性详细介绍,判断是否属于背景知识中所列举的不支持情况。

对于无法使用attributeModifier封装的属性,需要在每个组件尾部直接调用属性方法,也可以尝试使用@Styles装饰器和@Extend装饰器实现类似attributeModifier的封装效果。