
【中秋国庆不断更】OpenHarmony定义可动画属性:@AnimatableExtend装饰器 原创
【中秋国庆不断更】OpenHarmony定义可动画属性:@AnimatableExtend装饰器
@AnimatableExtend装饰器用于自定义可动画的属性方法,在这个属性方法中修改组件不可动画的属性。在动画执行过程时,通过逐帧回调函数修改不可动画属性值,让不可动画属性也能实现动画效果。
● 可动画属性:如果一个属性方法在animation属性前调用,改变这个属性的值可以生效animation属性的动画效果,这个属性称为可动画属性。比如height、width、backgroundColor、translate等。
● 不可动画属性:如果一个属性方法在animation属性前调用,改变这个属性的值不能生效animation属性的动画效果,这个属性称为不可动画属性。比如Text组件的fontSize属性、Ployline组件的points属性等。
说明:
该装饰器从API Version 10开始支持。后续版本如有新增内容,则采用上角标单独标记该内容的起始版本。
装饰器使用说明
语法
● @AnimatableExtend仅支持定义在全局,不支持在组件内部定义。
● @AnimatableExtend定义的函数参数类型必须为number类型或者实现 AnimtableArithmetic接口的自定义类型。
● @AnimatableExtend定义的函数体内只能调用@AnimatableExtend括号内组件的属性方法。
AnimtableArithmetic接口说明
对复杂数据类型做动画,需要实现AnimtableArithmetic接口中加法、减法、乘法和判断相等函数。
名称 | 入参类型 | 返回值类型 | 说明 |
plus | AnimtableArithmetic | AnimtableArithmetic | 加法函数 |
subtract | AnimtableArithmetic | AnimtableArithmetic | 减法函数 |
multiply | number | AnimtableArithmetic | 乘法函数 |
equals | AnimtableArithmetic | boolean | 相等判断函数 |
使用场景
以下示例实现字体大小的动画效果。
file
以下示例实现折线的动画效果。
file
