鸿蒙UI开发——badge角标的使用
蓝亭书序
2026-11-18 14:24:36 发布0 浏览 0 收藏
1、概 述
badge小红点角标是我们项目开发中常见的需求,信息标记组件,可以附加在单个组件上用于信息提醒的容器组件。效果如下:

2、Badge
接口定义如下:
👉🏻 根据数字创建标记组件;
Badge(value: BadgeParamWithNumber)效果如下:

👉🏻 根据字符串创建标记组件。
Badge(value: BadgeParamWithString)效果如下:

其中BadgeParamWithNumber与BadgeParamWithString都继承自BadgeParam,BadgeParam属性定义如下:
| 名称 | 类型 | 说明 |
| position | Position | 设置提示点显示位置。默认值:BadgePosition.RightTop说明:Position作为入参,不支持设置百分比;设置为非法值时,默认(0,0)处理。(0,0)为组件左上角位置。 |
| style | BadgeStyle | Badge组件可设置样式,支持设置文本颜色、尺寸、圆点颜色和尺寸。 |
其中,Position是枚举,定义如下:
RightTop = 0 // 圆点显示在右上角。
Right = 1 // 圆点显示在右侧纵向居中。
Left = 2 // 圆点显示在左侧纵向居中。
BadgeStyle定义如下:
| 名称 | 类型 | 说明 |
| color | ResourceColor | 文本颜色。默认值:Color.White |
| fontSize | number | string | 文本大小。默认值:10单位:fp说明:不支持设置百分比。 |
| badgeSize | number | string | Badge的大小。默认值:16单位:vp说明:不支持设置百分比。当设置为非法值时,按照默认值处理。 |
| badgeColor | ResourceColor | Badge的颜色。默认值:Color.Red |
| fontWeight | number |FontWeight | string | 设置文本的字体粗细。默认值:FontWeight.Normal说明:不支持设置百分比。 |
| borderColor | ResourceColor | 底板描边颜色。默认值:Color.Red |
| borderWidth | Length | 底板描边粗细。默认值:1单位:vp说明:不支持设置百分比。 |
3、案 例
由于BadgeParamWithNumber与BadgeParamWithString的区别只是显示的是数字还是字符串,因此以数字做简单示例。
演示效果如下(角标数值为0时,将不会显示角标):

代码如下(8 ~ 12行):
// 该示例实现了Badge组件显隐时缩放
@Entry
@Component
struct Index {
@State badgeCount: number = 0
build() {
Column({ space: 40 }) {
Badge({
count: this.badgeCount,
style: {},
position: BadgePosition.RightTop,
}) {
Image($r("app.media.startIcon"))
.width(50)
.height(50)
}
.width(55)
Button('增加count').onClick(() => {
this.badgeCount++;
})
}
.margin({ top: 20 })
.width('100%')
}
}
©本站发布的所有内容,包括但不限于文字、图片、音频、视频、图表、标志、标识、广告、商标、商号、域名、软件、程序等,除特别标明外,均来源于网络或用户投稿,版权归原作者或原出处所有。我们致力于保护原作者版权,若涉及版权问题,请及时联系我们进行处理。
分类
HarmonyOS
标签
组件
鸿蒙UI
badge
暂无评论数据
加载中...
发布
相关推荐
鸿蒙UI开发——布局优先级
蓝亭书序
0
0鸿蒙UI开发——实现按比例布局
蓝亭书序
0
0鸿蒙UI开发——空间的均匀分配
蓝亭书序
0
0鸿蒙UI开发——组件的自适应拉伸
蓝亭书序
0
0鸿蒙UI开发——Builder函数的封装
蓝亭书序
0
0
蓝亭书序
我还没有写个人简介......
144
帖子
0
提问
236
粉丝
最新发布
鸿蒙UI开发——布局优先级
2026-11-18 14:32:08 发布鸿蒙UI开发——实现按比例布局
2026-11-18 14:30:54 发布热门推荐
23445 浏览
23030 浏览
20621 浏览
相关问题




京公网安备:11010502051901号