鸿蒙UI开发——组件点击回弹效果

1、概 述

从API Version 10开始支持，ArkUI支持设置组件点击时回弹效果。我们可以通过为组件设置clickEffect来实现点击回弹效果。下面对clickEffect接口做展开说明。

2、clickEffect

接口定义如下：

// 设置当前组件点击回弹效果。
clickEffect(value: ClickEffect | null)

clickEffect的参数是ClickEffect，结构定义如下：

struct ClickEffect {
 /* 说明：
 level等于undefined或者null时，
 ClickEffect采用ClickEffectLevel.LIGHT对应的回弹效果, 
 缩放比参照scale说明。
*/
level: ClickEffectLevel // 设置当前组件点击回弹效果。

/*
 说明：
 level等于ClickEffectLevel.LIGHT时，默认值：0.90
 level等于ClickEffectLevel.MIDDLE或者ClickEffectLevel.HEAVY时，默认值：0.95
 level等于undefined或者null时，level为ClickEffectLevel.LIGHT，默认值：0.90
 scale等于undefined或者null时，scale与当前设置的level对应的默认缩放比相同。
 */ 
scale: number // 回弹缩放比例，支持在设置ClickEffectLevel的基础上微调回弹缩放比例。

}

ClickEffectLevel是枚举，定义如下：

enum ClickEffectLevel {
// 小面积（轻盈）  弹簧动效， 刚性：410，阻尼：38，初始速度：1  90%
LIGHT,
// 中面积（稳定）  弹簧动效， 刚性：350，阻尼：35，初始速度：0.5  95%
MIDDLE,
// 大面积（厚重）  弹簧动效， 刚性：240，阻尼：28，初始速度：0  95%
HEAVY
}

3、示例

实现一个示例效果如下：

代码如下（10、18、29、37、50、59行代码）：

// xxx.ets
@Entry
@Component
struct ToggleExample {
  build() {
    Column({ space: 10 }) {
      Text('type: Switch').fontSize(12).fontColor(0xcccccc).width('90%')
      Flex({ justifyContent: FlexAlign.SpaceEvenly, alignItems: ItemAlign.Center }) {
        Toggle({ type: ToggleType.Switch, isOn: false })
          .clickEffect({level:ClickEffectLevel.LIGHT})
          .selectedColor('#007DFF')
          .switchPointColor('#FFFFFF')
          .onChange((isOn: boolean) => {
            console.info('Component status:' + isOn)
          })

        Toggle({ type: ToggleType.Switch, isOn: true })
          .clickEffect({level:ClickEffectLevel.LIGHT, scale: 0.5})
          .selectedColor('#007DFF')
          .switchPointColor('#FFFFFF')
          .onChange((isOn: boolean) => {
            console.info('Component status:' + isOn)
          })
      }

      Text('type: Checkbox').fontSize(12).fontColor(0xcccccc).width('90%')
      Flex({ justifyContent: FlexAlign.SpaceEvenly, alignItems: ItemAlign.Center }) {
        Toggle({ type: ToggleType.Checkbox, isOn: false })
          .clickEffect({level:ClickEffectLevel.MIDDLE})
          .size({ width: 20, height: 20 })
          .selectedColor('#007DFF')
          .onChange((isOn: boolean) => {
            console.info('Component status:' + isOn)
          })

        Toggle({ type: ToggleType.Checkbox, isOn: true })
          .clickEffect({level:ClickEffectLevel.MIDDLE, scale: 0.5})
          .size({ width: 20, height: 20 })
          .selectedColor('#007DFF')
          .onChange((isOn: boolean) => {
            console.info('Component status:' + isOn)
          })
      }

      Text('type: Button').fontSize(12).fontColor(0xcccccc).width('90%')
      Flex({ justifyContent: FlexAlign.SpaceEvenly, alignItems: ItemAlign.Center }) {
        Toggle({ type: ToggleType.Button, isOn: false }) {
          Text('status button').fontColor('#182431').fontSize(12)
        }.width(106)
        .clickEffect({level:ClickEffectLevel.HEAVY})
        .selectedColor('rgba(0,125,255,0.20)')
        .onChange((isOn: boolean) => {
          console.info('Component status:' + isOn)
        })

        Toggle({ type: ToggleType.Button, isOn: true }) {
          Text('status button').fontColor('#182431').fontSize(12)
        }.width(106)
        .clickEffect({level:ClickEffectLevel.HEAVY, scale: 0.5})
        .selectedColor('rgba(0,125,255,0.20)')
        .onChange((isOn: boolean) => {
          console.info('Component status:' + isOn)
        })
      }
    }.width('100%').padding(24)
  }
}