HarmonyOS：Counter计数器组件

一、概述

计数器组件，提供相应的增加或者减少的计数操作。

说明
该组件从API Version 7开始支持。后续版本如有新增内容，则采用上角标单独标记该内容的起始版本。

二、属性

除支持通用属性外，还支持以下属性。

enableInc
enableInc(value: boolean)

设置增加按钮禁用或使能。

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

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

参数：

enableDec
enableDec(value: boolean)

设置减少按钮禁用或使能。

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

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

参数：

三、事件

除支持通用事件外，还支持以下事件：

onInc
onInc(event: () => void)

监听数值增加事件。

卡片能力： 从API version 9开始，该接口支持在ArkTS卡片中使用。

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

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

onDec
onDec(event: () => void)

监听数值减少事件。

卡片能力： 从API version 9开始，该接口支持在ArkTS卡片中使用。

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

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

四、示例

示例效果图

示例代码
TestCounter.ets

@Entry
@Component
struct TestCounter {
  @State message: string = '计数器组件';
  @State value: number = 0;

  build() {
    Column({ space: 10 }) {
      Text('禁用计数器组件的增加和减少按钮')
        .id('TestCounterHelloWorld')
        .fontSize(20)
        .fontWeight(FontWeight.Bold)
        .margin({ top: 20 })

      Counter() {
        Text(this.value.toString())
      }
      .enableDec(false)
      .enableInc(false)

      Text(this.message)
        .id('TestCounterHelloWorld')
        .fontSize(20)
        .fontWeight(FontWeight.Bold)
        .margin({ top: 20 })

      Counter() {
        Text(this.value.toString())
      }
      .onInc(() => {
        this.value++
        console.log(`点击了 增加按钮 this.value = ${this.value}`);
      })
      .onDec(() => {
        this.value--
        console.log(`点击了 减少按钮 this.value = ${this.value}`);
      })
    }
    .height('100%')
    .width('100%')
  }
}