OpenHarmony定义可动画属性：@AnimatableExtend装饰器

动画属性扩展

最新推荐文章于 2025-03-23 22:13:36 发布

原创

最新推荐文章于 2025-03-23 22:13:36 发布 · 892 阅读

CC 4.0 BY-SA版权

文章标签：

@AnimatableExtend装饰器用于自定义可动画的属性方法，在这个属性方法中修改组件不可动画的属性。在动画执行过程时，通过逐帧回调函数修改不可动画属性值，让不可动画属性也能实现动画效果。

● 可动画属性：如果一个属性方法在animation属性前调用，改变这个属性的值可以生效animation属性的动画效果，这个属性称为可动画属性。比如height、width、backgroundColor、translate等。

● 不可动画属性：如果一个属性方法在animation属性前调用，改变这个属性的值不能生效animation属性的动画效果，这个属性称为不可动画属性。比如Text组件的fontSize属性、Ployline组件的points属性等。

说明：

该装饰器从API Version 10开始支持。后续版本如有新增内容，则采用上角标单独标记该内容的起始版本。

@AnimatableExtend(UIComponentName) function functionName(value: typeName) { 
  .propertyName(value)
}

● @AnimatableExtend仅支持定义在全局，不支持在组件内部定义。

● @AnimatableExtend定义的函数参数类型必须为number类型或者实现 AnimtableArithmetic接口的自定义类型。

● @AnimatableExtend定义的函数体内只能调用@AnimatableExtend括号内组件的属性方法。

对复杂数据类型做动画，需要实现AnimtableArithmetic接口中加法、减法、乘法和判断相等函数。

名称	入参类型	返回值类型	说明
plus	AnimtableArithmetic	AnimtableArithmetic	加法函数
subtract	AnimtableArithmetic	AnimtableArithmetic	减法函数
multiply	number	AnimtableArithmetic	乘法函数
equals	AnimtableArithmetic	boo