点击回弹效果-视效与模糊-通用属性-ArkTS组件-ArkUI（方舟UI框架）-应用框架

点击回弹效果

Phone12+PC/2in113+Tablet12+TV19+Wearable18+

更新时间: 2026-08-29 09:41

设置组件的点击回弹效果。

说明

从API version 10开始支持。后续版本如有新增内容，则采用上角标单独标记该内容的起始版本。
本模块接口仅可在Stage模型下使用。

clickEffect

Phone12+PC/2in113+Tablet12+TV19+Wearable18+

clickEffect(value: ClickEffect | null): T

设置当前组件的点击回弹效果。点击回弹效果的强度等级决定回弹时的缩放幅度。

元服务API： 从API version 11开始，该接口支持在元服务中使用。

系统能力： SystemCapability.ArkUI.ArkUI.Full

参数：

展开

参数名	类型	必填	说明
value	ClickEffect \| null	是	设置当前组件点击回弹效果。说明：可通过null取消点击回弹效果。不建议在组件大小动态变化的场景中使用该功能，可能导致回弹效果异常。当组件无法触发通用事件（如点击事件等事件）时，不支持该属性。回弹触发缩放后可能造成触摸点不在组件上，组件上无法响应手势事件。

参数名

类型

必填

说明

value

ClickEffect | null

是

设置当前组件点击回弹效果。

说明：

可通过null取消点击回弹效果。

不建议在组件大小动态变化的场景中使用该功能，可能导致回弹效果异常。

当组件无法触发通用事件（如点击事件等事件）时，不支持该属性。

回弹触发缩放后可能造成触摸点不在组件上，组件上无法响应手势事件。

返回值：

展开

类型	说明
T	返回当前组件，用于链式调用。

clickEffect¹⁸⁺

Phone18+PC/2in118+Tablet18+TV19+Wearable18+

clickEffect(effect: Optional<ClickEffect | null>): T

设置当前组件的点击回弹效果。与clickEffect相比，新增了对undefined类型的支持。点击回弹效果的等级级别决定回弹时的缩放幅度。

元服务API： 从API version 18开始，该接口支持在元服务中使用。

系统能力： SystemCapability.ArkUI.ArkUI.Full

参数：

展开

参数名	类型	必填	说明
effect	Optional<ClickEffect \| null>	是	点击回弹效果的级别，用于控制回弹的强度程度。说明：可通过undefined或者null取消点击回弹效果。不建议在组件大小动态变化的场景中使用该功能。当组件无法触发通用事件（如点击事件等事件）时，不支持该属性。具体包括：组件被设置为disabled状态、组件不可见、组件被其他组件遮挡等场景下，无法触发通用事件，此时clickEffect属性不生效。回弹触发缩放后可能造成触摸点不在组件上，组件上无法响应手势事件。

参数名

类型

必填

说明

effect

Optional<ClickEffect | null>

是

点击回弹效果的级别，用于控制回弹的强度程度。

说明：

可通过undefined或者null取消点击回弹效果。

不建议在组件大小动态变化的场景中使用该功能。

当组件无法触发通用事件（如点击事件等事件）时，不支持该属性。具体包括：组件被设置为disabled状态、组件不可见、组件被其他组件遮挡等场景下，无法触发通用事件，此时clickEffect属性不生效。

回弹触发缩放后可能造成触摸点不在组件上，组件上无法响应手势事件。

返回值：

展开

类型	说明
T	返回当前组件，用于链式调用。

ClickEffect对象说明

Phone12+PC/2in113+Tablet12+TV19+Wearable18+

定义点击回弹效果。

元服务API： 从API version 11开始，该接口支持在元服务中使用。

系统能力： SystemCapability.ArkUI.ArkUI.Full

展开

名称	类型	只读	可选	说明
level	ClickEffectLevel	否	否	点击回弹效果级别，其取值影响scale的默认缩放比例。默认值：ClickEffectLevel.LIGHT 说明：当level为undefined或者null时， ClickEffect采用ClickEffectLevel.LIGHT对应的回弹效果，缩放比的具体默认值请参见下方scale属性说明。
scale	number	否	是	回弹缩放比例，取值范围(0, 1]，支持在设置ClickEffectLevel的基础上微调。超出取值范围时，使用当前level对应的默认缩放比例。说明：当level为ClickEffectLevel.LIGHT时，默认值：0.90 当level为ClickEffectLevel.MIDDLE或者ClickEffectLevel.HEAVY时，默认值：0.95 当level为undefined或者null时，level为ClickEffectLevel.LIGHT，默认值：0.90 当scale为undefined或者null时，使用当前level对应的默认缩放比例。

名称

类型

只读

可选

说明

level

ClickEffectLevel

否

点击回弹效果级别，其取值影响scale的默认缩放比例。

默认值：ClickEffectLevel.LIGHT

说明：

当level为undefined或者null时， ClickEffect采用ClickEffectLevel.LIGHT对应的回弹效果，缩放比的具体默认值请参见下方scale属性说明。

scale

number

否

是

回弹缩放比例，取值范围(0, 1]，支持在设置ClickEffectLevel的基础上微调。超出取值范围时，使用当前level对应的默认缩放比例。

说明：

当level为ClickEffectLevel.LIGHT时，默认值：0.90

当level为ClickEffectLevel.MIDDLE或者ClickEffectLevel.HEAVY时，默认值：0.95

当level为undefined或者null时，level为ClickEffectLevel.LIGHT，默认值：0.90

当scale为undefined或者null时，使用当前level对应的默认缩放比例。

示例

该示例主要演示不同组件的点击回弹效果。

// 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)
  }
}

点击回弹效果

clickEffect

clickEffect18+

ClickEffect对象说明

示例

clickEffect¹⁸⁺