鸿蒙5.0开发进阶:UI框架-ArkTS组件(advanced.Counter)

HarmonyOS NEXT实战开发:NDK接口接入ArkTS页面实例 使用NDK接口构建UI界面时,需要在ArkTS页面创建用于挂载NDK接口创建组件的占位组件。 阅读详情

往期鸿蒙5.0全套实战文章必看:(文中附带全栈鸿蒙5.0学习资料)


advanced.Counter

Counter是用于精确调节数值的组件。

说明

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

导入模块

import { CounterType, CounterComponent, CounterOptions, DateData } from '@kit.ArkUI';

子组件

无

CounterComponent

CounterComponent({ options: CounterOptions })

定义计数器组件。

装饰器类型:@Component

元服务API: 从API version 12开始,该接口支持在元服务中使用。

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

参数:

名称类型必填装饰器类型说明
optionsCounterOptions是@Prop定义counter组件的类型。

CounterOptions

CounterOptions定义Counter的类型及具体式样参数。

元服务API: 从API version 12开始,该接口支持在元服务中使用。

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

名称类型必填说明
typeCounterType是指定当前Counter的类型。
direction12+Direction否

布局方向。

默认值:Direction.Auto

numberOptionsNumberStyleOptions否列表型和紧凑型counter的式样。
inlineOptionsInlineStyleOptions否普通数字内联调节型Counter的式样。
dateOptionsDateStyleOptions否日期型内联型counter的式样。

选择不同的counter类型,需要选择对应的counter式样,其对应关系如下:

counter类型counter式样
CounterType.LISTNumberStyleOptions
CounterType.COMPACTNumberStyleOptions
CounterType.INLINEInlineStyleOptions
CounterType.INLINE_DATEDateStyleOptions

CounterType

CounterType指定Counter的类型,如列表型Counter。

元服务API: 从API version 12开始,该接口支持在元服务中使用。

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

名称说明
LIST列表型Counter。
COMPACT紧凑型Counter。
INLINE普通数字内联调节型Counter。
INLINE_DATE日期型内联型Counter。

CommonOptions

CommonOptions定义Counter的共通属性和事件。

元服务API: 从API version 12开始,该接口支持在元服务中使用。

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

名称类型必填默认值说明
focusableboolean否true

设置Counter是否可以获焦。

说明:

该属性对列表型、紧凑型Counter生效。

stepnumber否1

设置Counter的步长。

取值范围:大于等于1的整数。

onHoverIncrease(isHover: boolean) =>void否-

鼠标进入或退出Counter组件的增加按钮触发该回调。

isHover:表示鼠标是否悬浮在组件上,鼠标进入时为true, 退出时为false。

onHoverDecrease(isHover: boolean) =>void否-

鼠标进入或退出Counter组件的减小按钮触发该回调。

isHover:表示鼠标是否悬浮在组件上,鼠标进入时为true, 退出时为false。

InlineStyleOptions

InlineStyleOptions定义Inline Style(数值内联型Counter)的属性和事件。

继承于CommonOptions 。

元服务API: 从API version 12开始,该接口支持在元服务中使用。

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

名称类型必填默认值说明
valuenumber否0设置Counter的初始值。
minnumber否0设置Counter的最小值。
maxnumber否999设置Counter的最大值。
textWidthnumber否0设置数值文本的宽度。
onChange(value: number) =>void否-

当数值改变时,返回当前值。

value:当前显示的数值。

NumberStyleOptions

NumberStyleOptions定义Number style(列表型Counter和紧凑型Counter)的属性和事件。

继承于InlineStyleOptions。

元服务API: 从API version 12开始,该接口支持在元服务中使用。

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

名称类型必填默认值说明
labelResourceStr否-设置Counter的说明文本。
onFocusIncrease() =>void否-当前Counter组件增加按钮获取焦点时触发的回调。
onFocusDecrease() =>void否-当前Counter组件减小按钮获取焦点时触发的回调。
onBlurIncrease() =>void否-当前Counter组件增加按钮失去焦点时触发的回调。
onBlurDecrease() =>void否-当前Counter组件减小按钮失去焦点时触发的回调。

DateStyleOptions

DateStyleOptions定义Date style(日期内联型Counter)的属性和事件。

继承于CommonOptions 。

元服务API: 从API version 12开始,该接口支持在元服务中使用。

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

名称类型必填默认值说明
yearnumber否1设置日期内联型初始年份。
monthnumber否1设置日期内联型初始月份。
daynumber否1设置日期内联型初始日。
onDateChange(date: DateData)=>void否-

当日期改变时,返回当前日期。

date:当前显示的日期值。

DateData

DateData定义Date通用属性和方法,如年、月、日。

元服务API: 从API version 12开始,该接口支持在元服务中使用。

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

名称类型说明
yearnumber设置日期内联型初始年份。
monthnumber设置日期内联型初始月份。
daynumber设置日期内联型初始日。

constructor

constructor(year: number, month: number, day: number)

DateData的构造函数。

元服务API:从API version 12 开始,该接口支持在元服务中使用。

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

参数名类型说明
yearnumber设置日期内联型初始年份。
monthnumber设置日期内联型初始月份。
daynumber设置日期内联型初始日。

toString

toString(): string

以字符串格式返回当前日期值。

元服务API:从API version 12 开始,该接口支持在元服务中使用。

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

返回值:

类型说明
string当前日期值。

示例

示例1(列表型Counter)

该示例通过设置type为CounterType.LIST以及numberOptions,实现列表型Counter。

import { CounterType, CounterComponent } from '@kit.ArkUI';

@Entry
@Component
struct ListCounterExample {
  build() {
    Column() {
      //列表型Counter
      CounterComponent({
        options: {
          type: CounterType.LIST,
          numberOptions: {
            label: "价格",
            min: 0,
            value: 5,
            max: 10
          }
        }
      })
    }
  }
}

示例2(紧凑型Counter)

该示例通过设置type为CounterType.COMPACT以及numberOptions,实现紧凑型Counter。

import { CounterType, CounterComponent } from '@kit.ArkUI';

@Entry
@Component
struct CompactCounterExample {
  build() {
    Column() {
      //紧凑型Counter
      CounterComponent({
        options: {
          type: CounterType.COMPACT,
          numberOptions: {
            label: "数量",
            value: 10,
            min: 0,
            max: 100,
            step: 10
          }
        }
      })
    }
  }
}

示例3(数值内联型Counter)

该示例通过设置type为CounterType.INLINE以及inlineOptions,实现数值内联型Counter。

import { CounterType, CounterComponent } from '@kit.ArkUI';

@Entry
@Component
struct NumberStyleExample {
  build() {
    Column() {
      //数值内联型Counter
      CounterComponent({
        options: {
          type: CounterType.INLINE,
          inlineOptions: {
            value: 100,
            min: 10,
            step: 2,
            max: 1000,
            textWidth: 100,
            onChange: (value: number) => {
              console.log("onDateChange Date: " + value.toString());
            }
          }
        }
      })
    }
  }
}

示例4(日期内联型Counter)

该示例通过设置type为CounterType.INLINE_DATE以及dateOptions,实现日期内联型Counter,用户可以手动输入日期。

import { CounterType, CounterComponent, DateData } from '@kit.ArkUI';

@Entry
@Component
struct DataStyleExample {
  build() {
    Column() {
      //日期内联型counter
      CounterComponent({
        options: {
          type: CounterType.INLINE_DATE,
          dateOptions: {
            year: 2016,
            onDateChange: (date: DateData) => {
              console.log("onDateChange Date: " + date.toString());
            }
          }
        }
      })
    }
  }
}

示例5(镜像布局展示)

该示例通过设置direction属性,实现列表型、紧凑型、数字内联型、日期内联型Counter进行镜像布局。

// xxx.ets
import { CounterType, CounterComponent, DateData } from '@kit.ArkUI';

@Entry
@Component
struct CounterPage {
  @State currentDirection: Direction = Direction.Rtl

  build() {
    Column({}) {

      //列表型Counter
      CounterComponent({
        options: {
          direction: this.currentDirection,
          type: CounterType.LIST,
          numberOptions: {
            label: "价格",
            min: 0,
            value: 5,
            max: 10,
          }
        }
      })
        .width('80%')

      //数值型Counter
      CounterComponent({
        options: {
          direction: this.currentDirection,
          type: CounterType.COMPACT,
          numberOptions: {
            label: "数量",
            value: 10,
            min: 0,
            max: 100,
            step: 10
          }
        }
      }).margin({ top: 20 })

      //数值内联型Counter
      CounterComponent({
        options: {
          type: CounterType.INLINE,
          direction: this.currentDirection,
          inlineOptions: {
            value: 100,
            min: 10,
            step: 2,
            max: 1000,
            textWidth: 100,
            onChange: (value: number) => {
              console.log("onDateChange Date: " + value.toString());
            }
          }
        }
      }).margin({ top: 20 })
      //日期内联型counter
      CounterComponent({
        options: {
          direction: this.currentDirection,
          type: CounterType.INLINE_DATE,
          dateOptions: {
            year: 2024,
            onDateChange: (date: DateData) => {
              console.log("onDateChange Date: " + date.toString());
            }
          }
        }
      }).margin({ top: 20 })
    }
    .width('100%')
    .height('100%')
    .justifyContent(FlexAlign.Center)
    .alignItems(HorizontalAlign.Center)
  }
}

鸿蒙5.0版开发:ArkTS高级组件-@ohos.arkui.advanced.Counter (计数器组件) Counter是用于精确调节数值的组件。 阅读详情

相关推荐

HarmonyOS实战开发:UI框架-ArkTS组件(自定义组件内置方法)

自定义组件内置方法是由ArkUI开发框架提供给应用开发者的,定义在自定义组件基类上的API。应用开发者可以在自定义组件的实例上调用对应的API以获取当前自定义组件实例相关的信息。例如,查询当前自定组件上下文的UIContext信息。

2401_84917132的博客 1596

HarmonyOS鸿蒙开发如何读取工程目录中的非图片资源文件(pdf,word,txt等等)的uri

而且文件必须保存在特定目录下,以yyyy.pdf为例。这些里面是找不到项目目录中的资源文件的。将文件写入沙盒路径获取uri。然后通过资源管理方式读取。

qq_15509071的博客 2549

鸿蒙NEXT开发【@ohos.arkui.drawableDescriptor (DrawableDescriptor)】 UI界面API

本模块提供获取pixelMap的能力,包括前景、背景、蒙版和分层图标。

CS9527DND的博客 1101

鸿蒙(HarmonyOS)项目方舟框架(ArkUI)之Counter容器组件

鸿蒙(HarmonyOS)项目方舟框架(ArkUI)之Counter容器组件。

zy0412326的专栏 442

HarmonyOS ArkTS文件加密实战:基于AES-GCM与安全密钥库的本地数据保护方案

在移动应用开发中,数据安全是保障用户隐私的核心环节,尤其涉及本地文件存储时。对称加密技术通过使用同一密钥进行加密和解密,是实现高效数据保护的主流方案,其中AES(高级加密标准)因其安全性与性能平衡被广泛采用。其技术价值在于能有效防止敏感信息在存储介质被直接访问时泄露,适用于离线报告、表单草稿等用户隐私数据的本地加密场景。本文以HarmonyOS ArkTS为实践环境,深入讲解如何利用其原生加解密框架(cryptoFramework)与文件管理系统,结合AES-GCM模式实现具备认证功能的文件加密解密流程,并

579

HarmonyOS Next开发学习手册——动画曲线

动画曲线是属性关于时间的变化函数,决定属性变化时产生动画的运动轨迹。某一时刻下动画曲线的斜率代表动画的速度,对应属性变化的快慢。一条优秀的动画曲线具备连续光滑、符合用户意图、符合物理世界客观规律的特点。开发者可结合用户的使用场景和意图,为动效选取合适的动画曲线。根据动画曲线是否符合物理世界客观规律,可将其分为物理曲线(ArkUI当前提供了多种物理弹簧曲线)和传统曲线两种类型。相比于传统曲线,物理曲线产生的运动轨迹更加符合用户认知,有助于创造自然生动的动画效果,建议开发者优先使用物理曲线。

maniuT的博客 939

#跟着若城学鸿蒙# UI组件篇-Counter及其属性

Counter 组件主要用于在用户界面中显示和调整数值。它提供了一种直观的方式来增加或减少数值,适用于各种需要数值调节的场景,如购物车数量调整、评分系统、时间选择等。

Huang兄 688

鸿蒙NEXT开发ArkUI【BuilderNode】 UI界面

节点渲染类型枚举。

CS9527DND的博客 916

鸿蒙5.0版开发:ArkUI框架开发-嵌入ArkTS组件

ArkUI在Native侧提供的能力作为ArkTS的子集...........

m0_73088370的博客 1320

鸿蒙Harmony应用开发—ArkTS声明式开发(容器组件:Counter)

ArkTS声明式开发(容器组件:Counter)

m0_64420071的博客 1387

HarmonyOS应用开发:Counter(容器组件)

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

situnanQAQ的博客 476

鸿蒙5.0版开发:ArkUI框架开发-自定义占位节点

ArkUI提供了ArkTS原生组件作为自定义节点的占位节点。

m0_73088370的博客 609

鸿蒙5.0版开发:UI界面-@ohos.arkui.componentUtils (componentUtils)

提供获取组件绘制区域坐标和大小的能力。

m0_69424697的博客 1298

鸿蒙API13开发【信息展示之Counter】ArkTS组件

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

鸿蒙的技术博客 467

鸿蒙HarmonyOS开发:构建ArkUI应用级和页面级主题设置

针对应用,构建ArkUI应用级和页面级主题设置能力,并提供局部深浅色模式设置、动态换肤等功能。

2401_84917132的博客 1481

鸿蒙HarmonyOS开发:嵌入ArkTS组件

ArkUI在Native侧提供的能力作为ArkTS的子集,部分能力不会在Native侧提供,如声明式UI语法,自定义struct组件,UI高级组件。

2401_84917132的博客 1106

【鸿蒙软件开发】ArkUI之容器组件Counter(计数器组件)、Flex(弹性布局)

Counter容器组件:计数器组件,提供相应的增加或者减少的计数操作。Flex容器组件:以弹性方式布局子组件的容器组件。下面这些容器组件对于我们ArkUI界面的开发非常重要,希望大家好好学。Counter容器组件:计数器组件,提供相应的增加或者减少的计数操作。Flex容器组件:以弹性方式布局子组件的容器组件。

m0_62599305的博客 1262

毕业设计——基于卷积神经网络的高速公路团雾智能识别系统设计与实现(数据集+源码+可视化+综述)

同时,也可以结合其他技术,如雷达、红外传感器等,实现多源信息的融合与协同处理,提高系统的可靠性和稳定性。实验结果表明,该系统能够实现对高速公路团雾的准确、快速识别,为高速公路的安全运行提供了有力保障。团雾作为一种常见的气象现象,具有突发性、局地性和消散迅速的特点,对高速公路的行车安全构成严重威胁。通过设计合适的网络结构,如增加卷积层、池化层等,实现对图像中团雾特征的自动学习和提取。预处理:对采集到的图像进行去噪、增强等预处理操作,以提高图像质量,降低后续处理的难度。读取数据,随机分为训练集和验证集。

abackcab的博客 668

OpenHarmony实战开发-Web组件开发性能提升指导。

开发者实现在应用中跳转显示网页需要分为两个方面:使用@ohos.web.webview提供Web控制能力;使用Web组件提供网页显示的能力。在实际应用中往往由于各种原因导致首次跳转Web网页或Web组件内跳转时出现白屏、卡顿等情况。本文介绍提升Web首页加载与Web网页间跳转速度的几种方法。

2401_82546228的博客 1583

数据中心——Vxlan基本概念1

东西流量指的就是横向流量-------例如:服务器与服务器之间交换流量南北流量指的就是纵向流量-------例如:客户端和服务器之间的流量以下主要是讲解业务平面的网络架构(一般业务平面就需要用到专用的数据中心交换机)

m0_49864110的博客 1万+

Tessent ATPG进阶:解锁多种Fault Model的工程实践与选型指南

本文深入探讨Tessent ATPG中多种Fault Model的工程实践与选型策略,涵盖Stuck-at、Transition、Bridge等核心模型的应用场景与配置技巧。通过实际案例解析,展示如何组合不同Fault Model提升芯片测试覆盖率,特别针对汽车电子、超低功耗芯片等复杂场景提供专业解决方案。

weixin_30219613的博客 200
上一篇: 鸿蒙5.0开发进阶:UI框架-ArkTS组件(Counter)
下一篇: 鸿蒙5.0开发进阶:UI框架-ArkTS组件(DataPanel)
懂你的大海
博客等级 码龄6年 9049粉丝 1381原创
评论
成就一亿技术人!
拼手气红包6.0元
还能输入1000个字符
 
 条评论被折叠 查看
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付:10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值