鸿蒙ArkTS容器组件：【Badge】

最新推荐文章于 2025-05-14 10:23:36 发布

鸿蒙系统小能手Mr.Li

最新推荐文章于 2025-05-14 10:23:36 发布

阅读量1.1k

点赞数 29

分类专栏：鸿蒙开发文章标签： harmonyos OpenHarmony 鸿蒙开发鸿蒙组件 arkts 程序员

本文链接：https://blog.csdn.net/2401_82772199/article/details/140189831

版权

Badge

可以附加在单个组件上用于信息标记的容器组件。

说明：

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

子组件

支持单个子组件。

说明：
开发前请熟悉鸿蒙开发指导文档：gitee.com/li-shizhen-skin/harmony-os/blob/master/README.md点击或者复制转到。
子组件类型：系统组件和自定义组件，支持渲染控制类型（[if/else]、[ForEach]和[LazyForEach]）。

接口

Badge

Badge(value: {count: number, position?: BadgePosition | Position, maxCount?: number, style: BadgeStyle})

创建数字标记组件。

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

参数：

参数名	参数类型	必填	参数描述
count	number	是	设置提醒消息数。说明：小于等于0时不显示信息标记。取值范围：[-2147483648,2147483647]，非整数时会舍去小数部分取整数部分，如5.5取5。
position	[BadgePosition]	[Position10+]	否
maxCount	number	否	最大消息数，超过最大消息时仅显示maxCount+。默认值：99 取值范围：[-2147483648,2147483647]，非整数时会舍去小数部分取整数部分，如5.5取5。
style	[BadgeStyle]	是	Badge组件可设置样式，支持设置文本颜色、尺寸、圆点颜色和尺寸。