logo
积分中心
鸿蒙UI开发——badge角标的使用
头像 蓝亭书序 2026-11-18 14:24:36    发布
0 浏览 0 收藏

1、概 述

badge小红点角标是我们项目开发中常见的需求,信息标记组件,可以附加在单个组件上用于信息提醒的容器组件。效果如下:

图片

2、Badge

接口定义如下:

👉🏻 根据数字创建标记组件;


Badge(value: BadgeParamWithNumber)


效果如下:

图片

👉🏻 根据字符串创建标记组件。


Badge(value: BadgeParamWithString)


效果如下:

图片

其中BadgeParamWithNumber与BadgeParamWithString都继承自BadgeParam,BadgeParam属性定义如下:

名称类型说明
positionPosition设置提示点显示位置。默认值:BadgePosition.RightTop说明:Position作为入参,不支持设置百分比;设置为非法值时,默认(0,0)处理。(0,0)为组件左上角位置。
styleBadgeStyleBadge组件可设置样式,支持设置文本颜色、尺寸、圆点颜色和尺寸。

其中,Position是枚举,定义如下:


RightTop = 0 // 圆点显示在右上角。
Right = 1 // 圆点显示在右侧纵向居中。
Left = 2 // 圆点显示在左侧纵向居中。


BadgeStyle定义如下:

名称类型说明
colorResourceColor文本颜色。默认值:Color.White
fontSizenumber | string文本大小。默认值:10单位:fp说明:不支持设置百分比。
badgeSizenumber | stringBadge的大小。默认值:16单位:vp说明:不支持设置百分比。当设置为非法值时,按照默认值处理。
badgeColorResourceColorBadge的颜色。默认值:Color.Red
fontWeightnumber |FontWeight | string设置文本的字体粗细。默认值:FontWeight.Normal说明:不支持设置百分比。
borderColorResourceColor底板描边颜色。默认值:Color.Red
borderWidthLength底板描边粗细。默认值: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

暂无评论数据

加载中...

发布

地址:北京市朝阳区北三环东路三元桥曙光西里甲1号第三置业A座1508室 电话:13391790444或(010)62178877
版权所有:电脑商情信息服务集团 北京赢邦策略咨询有限责任公司
声明:本媒体部分图片、文章来源于网络,版权归原作者所有,我司致力于保护作者版权,如有侵权,请与我司联系删除

京ICP备:2022009079号-2

京公网安备:11010502051901号

ICP证:京B2-20230255