1# Counter 2<!--Kit: ArkUI--> 3<!--Subsystem: ArkUI--> 4<!--Owner: @liyujie43--> 5<!--Designer: @weixin_52725220--> 6<!--Tester: @xiong0104--> 7<!--Adviser: @HelloCrease--> 8 9计数器组件，提供相应的增加或者减少的计数操作。 10 11> **说明：** 12> 13> 该组件从API Version 7开始支持。后续版本如有新增内容，则采用上角标单独标记该内容的起始版本。 14 15 16## 子组件 17 18可以包含子组件。 19 20 21## 接口 22 23Counter() 24 25**卡片能力：** 从API version 9开始，该接口支持在ArkTS卡片中使用。 26 27**原子化服务API：** 从API version 11开始，该接口支持在原子化服务中使用。 28 29**系统能力：** SystemCapability.ArkUI.ArkUI.Full 30 31## 属性 32 33除支持[通用属性](ts-component-general-attributes.md)外，还支持以下属性。 34 35### enableInc<sup>10+</sup> 36 37enableInc(value: boolean) 38 39设置增加按钮的禁用或使能。 40 41**原子化服务API：** 从API version 11开始，该接口支持在原子化服务中使用。 42 43**系统能力：** SystemCapability.ArkUI.ArkUI.Full 44 45**参数：** 46 47| 参数名 | 类型 | 必填 | 说明 | 48| ------ | ------- | ---- | ------------------------------------- | 49| value | boolean | 是 | 增加按钮禁用或使能。<br/>默认值：true，true表示可以增加按钮，false表示禁止增加按钮。 | 50 51### enableDec<sup>10+</sup> 52 53enableDec(value: boolean) 54 55设置减少按钮的禁用或使能。 56 57**原子化服务API：** 从API version 11开始，该接口支持在原子化服务中使用。 58 59**系统能力：** SystemCapability.ArkUI.ArkUI.Full 60 61**参数：** 62 63| 参数名 | 类型 | 必填 | 说明 | 64| ------ | ------- | ---- | ------------------------------------- | 65| value | boolean | 是 | 减少按钮禁用或使能。<br/>默认值：true，true表示可以减少按钮，false表示禁止减少按钮。 | 66 67## 事件 68 69除支持[通用事件](ts-component-general-events.md)外，还支持以下事件： 70 71### onInc 72 73onInc(event: VoidCallback) 74 75监听数值增加事件。 76 77**卡片能力：** 从API version 9开始，该接口支持在ArkTS卡片中使用。 78 79**原子化服务API：** 从API version 11开始，该接口支持在原子化服务中使用。 80 81**系统能力：** SystemCapability.ArkUI.ArkUI.Full 82 83**参数：** 84 85| 参数名 | 类型 | 必填 | 说明 | 86| ------ | --------------------------------------------- | ---- | ----------------------------------- | 87| event | [VoidCallback](ts-types.md#voidcallback12) | 是 | Counter数值增加的回调函数。 | 88 89### onDec 90 91onDec(event: VoidCallback) 92 93监听数值减少事件。 94 95**卡片能力：** 从API version 9开始，该接口支持在ArkTS卡片中使用。 96 97**原子化服务API：** 从API version 11开始，该接口支持在原子化服务中使用。 98 99**系统能力：** SystemCapability.ArkUI.ArkUI.Full 100 101**参数：** 102 103| 参数名 | 类型 | 必填 | 说明 | 104| ------ | --------------------------------------------- | ---- | ----------------------------------- | 105| event | [VoidCallback](ts-types.md#voidcallback12) | 是 | Counter数值减少的回调函数。 | 106 107 108## 示例 109 110该示例展示了Counter组件的基本使用方法。点击+、-按钮可以修改value值。 111 112```ts 113// xxx.ets 114@Entry 115@Component 116struct CounterExample { 117 @State value: number = 0; 118 119 build() { 120 Column() { 121 Counter() { 122 Text(this.value.toString()) 123 }.margin(100) 124 .onInc(() => { 125 this.value++; 126 }) 127 .onDec(() => { 128 this.value--; 129 }) 130 }.width("100%") 131 } 132} 133``` 134 135 136
