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

HarmonyOS ArkUI容器类组件-角标组件(Badge) position?maxCount?: number;position?Badge的构造方法允许接收和两种类型的参数,它们都继承自BadgeParamBadgeParamposition:设置 badge 的显示位置,提供了以下 3 种位置:Right: badge 显示在右侧纵向居中。RightTop(默认值): badge 显示在右上角。Left: badge 显示在左侧纵向居中。style:设置 badge 的显示样式,BadgeStyle样式参数说明如下:color。 阅读详情

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


Badge

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

说明

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

子组件

支持单个子组件。

说明

子组件类型:系统组件和自定义组件,支持渲染控制类型(if/else、ForEach和LazyForEach)。

接口

Badge

Badge(value: BadgeParamWithNumber)

根据数字创建标记组件。

卡片能力: 从API version 9开始,该接口支持在ArkTS卡片中使用。

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

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

参数:

参数名类型必填说明
valueBadgeParamWithNumber是数字标记组件参数。

Badge

Badge(value: BadgeParamWithString)

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

卡片能力: 从API version 9开始,该接口支持在ArkTS卡片中使用。

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

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

从API version 12开始,该组件显隐时支持scale动效。

参数:

参数名类型必填说明
valueBadgeParamWithString是字符串标记组件参数。

BadgeParam对象说明

包含创建Badge组件的基础参数。

卡片能力: 从API version 9开始,该接口支持在ArkTS卡片中使用。

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

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

名称类型必填说明
positionBadgePosition|Position10+否

设置提示点显示位置。

默认值:BadgePosition.RightTop

说明:

Position作为入参,不支持设置百分比;设置为非法值时,默认(0,0)处理。(0,0)为组件左上角位置。

styleBadgeStyle是Badge组件可设置样式,支持设置文本颜色、尺寸、圆点颜色和尺寸。

BadgeParamWithNumber对象说明

BadgeParamWithNumber继承自BadgeParam,具有BadgeParam的全部属性。

卡片能力: 从API version 9开始,该接口支持在ArkTS卡片中使用。

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

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

名称类型必填说明
countnumber是

设置提醒消息数。

说明:

小于等于0且小于maxCount时不显示信息标记。

取值范围:[-2147483648,2147483647],超出范围时会加上或减去4294967296,使得值仍在范围内,非整数时会舍去小数部分取整数部分,如5.5取5。

maxCountnumber否

最大消息数,超过最大消息时仅显示maxCount+。

默认值:99

取值范围:[-2147483648,2147483647],超出范围时会加上或减去4294967296,使得值仍在范围内,非整数时会舍去小数部分取整数部分,如5.5取5。

BadgeParamWithString对象说明

BadgeParamWithString继承自BadgeParam,具有BadgeParam的全部属性。

卡片能力: 从API version 9开始,该接口支持在ArkTS卡片中使用。

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

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

名称类型必填说明
valuestring是提示内容的文本字符串。

BadgePosition枚举说明

卡片能力: 从API version 9开始,该接口支持在ArkTS卡片中使用。

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

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

名称值说明
RightTop0圆点显示在右上角。
Right1圆点显示在右侧纵向居中。
Left2圆点显示在左侧纵向居中。

BadgeStyle对象说明

卡片能力: 从API version 9开始,该接口支持在ArkTS卡片中使用。

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

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

名称类型必填说明
colorResourceColor否

文本颜色。

默认值:Color.White

fontSizenumber | string否

文本大小。

默认值:10

单位:fp

说明:

不支持设置百分比。

badgeSizenumber | string否

Badge的大小。

默认值:16

单位:vp

说明:

不支持设置百分比。当设置为非法值时,按照默认值处理。

badgeColorResourceColor否

Badge的颜色。

默认值:Color.Red

fontWeight10+number |FontWeight | string否

设置文本的字体粗细。

默认值:FontWeight.Normal

说明:

不支持设置百分比。

borderColor10+ResourceColor否

底板描边颜色。

默认值:Color.Red

borderWidth10+Length否

底板描边粗细。

默认值:1

单位:vp

说明:

不支持设置百分比。

属性

支持通用属性。

事件

支持通用事件。

示例

示例1(设置标记组件内容)

该示例通过value和count属性,实现了传入空值、字符、数字时标记组件展现不同的效果。

// xxx.ets
@Entry
@Component
struct BadgeExample {
  @Builder
  tabBuilder(index: number) {
    Column() {
      if (index === 2) {
        Badge({
          value: '',
          style: { badgeSize: 6, badgeColor: '#FA2A2D' }
        }) {
          Image('/common/public_icon_off.svg')
            .width(24)
            .height(24)
        }
        .width(24)
        .height(24)
        .margin({ bottom: 4 })
      } else {
        Image('/common/public_icon_off.svg')
          .width(24)
          .height(24)
          .margin({ bottom: 4 })
      }
      Text('Tab')
        .fontColor('#182431')
        .fontSize(10)
        .fontWeight(500)
        .lineHeight(14)
    }.width('100%').height('100%').justifyContent(FlexAlign.Center)
  }

  @Builder
  itemBuilder(value: string) {
    Row() {
      Image('common/public_icon.svg').width(32).height(32).opacity(0.6)
      Text(value)
        .width(177)
        .height(21)
        .margin({ left: 15, right: 76 })
        .textAlign(TextAlign.Start)
        .fontColor('#182431')
        .fontWeight(500)
        .fontSize(16)
        .opacity(0.9)
      Image('common/public_icon_arrow_right.svg').width(12).height(24).opacity(0.6)
    }.width('100%').padding({ left: 12, right: 12 }).height(56)
  }

  build() {
    Column() {
      // 红点类型的标记组件
      Text('dotsBadge').fontSize(18).fontColor('#182431').fontWeight(500).margin(24)
      Tabs() {
        TabContent()
          .tabBar(this.tabBuilder(0))
        TabContent()
          .tabBar(this.tabBuilder(1))
        TabContent()
          .tabBar(this.tabBuilder(2))
        TabContent()
          .tabBar(this.tabBuilder(3))
      }
      .width(360)
      .height(56)
      .backgroundColor('#F1F3F5')

      // 根据字符创建的标记组件
      Column() {
        Text('stringBadge').fontSize(18).fontColor('#182431').fontWeight(500).margin(24)
        List({ space: 12 }) {
          ListItem() {
            Text('list1').fontSize(14).fontColor('#182431').margin({ left: 12 })
          }
          .width('100%')
          .height(56)
          .backgroundColor('#FFFFFF')
          .borderRadius(24)
          .align(Alignment.Start)

          ListItem() {
            Badge({
              value: 'New',
              position: BadgePosition.Right,
              style: { badgeSize: 16, badgeColor: '#FA2A2D' }
            }) {
              Text('list2').width(27).height(19).fontSize(14).fontColor('#182431')
            }.width(49.5).height(19)
            .margin({ left: 12 })
          }
          .width('100%')
          .height(56)
          .backgroundColor('#FFFFFF')
          .borderRadius(24)
          .align(Alignment.Start)
        }.width(336)

        // 根据数字创建的标记组件
        Text('numberBadge').fontSize(18).fontColor('#182431').fontWeight(500).margin(24)
        List() {
          ListItem() {
            this.itemBuilder('list1')
          }

          ListItem() {
            Row() {
              Image('common/public_icon.svg').width(32).height(32).opacity(0.6)
              Badge({
                count: 1,
                position: BadgePosition.Right,
                style: { badgeSize: 16, badgeColor: '#FA2A2D' }
              }) {
                Text('list2')
                  .width(177)
                  .height(21)
                  .textAlign(TextAlign.Start)
                  .fontColor('#182431')
                  .fontWeight(500)
                  .fontSize(16)
                  .opacity(0.9)
              }.width(240).height(21).margin({ left: 15, right: 11 })

              Image('common/public_icon_arrow_right.svg').width(12).height(24).opacity(0.6)
            }.width('100%').padding({ left: 12, right: 12 }).height(56)
          }

          ListItem() {
            this.itemBuilder('list3')
          }

          ListItem() {
            this.itemBuilder('list4')
          }
        }
        .width(336)
        .height(232)
        .backgroundColor('#FFFFFF')
        .borderRadius(24)
        .padding({ top: 4, bottom: 4 })
        .divider({
          strokeWidth: 0.5,
          color: 'rgba(0,0,0,0.1)',
          startMargin: 60,
          endMargin: 12
        })
      }.width('100%').backgroundColor('#F1F3F5').padding({ bottom: 12 })
    }.width('100%')
  }
}

示例2(设置数字控制标记显隐)

该示例通过count属性,实现了设置数字0和1时标记组件的隐藏和显示效果。

// 该示例实现了Badge组件显隐时缩放
@Entry
@Component
struct Index {
  @State badgeCount: number = 1

  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 0').onClick(() => {
        this.badgeCount = 0
      })
      Button('count 1').onClick(() => {
        this.badgeCount = 1
      })
    }
    .margin({ top: 20 })
  }
}

鸿蒙5.0版开发:ArkTS容器组件(Badge) 可以附加在单个组件上用于信息标记的容器组件。 阅读详情

相关推荐

鸿蒙ArkTS容器组件:【Badge】

可以附加在单个组件上用于信息标记的容器组件。该组件从API Version 7开始支持。后续版本如有新增内容,则采用上角标单独标记该内容的起始版本。

2401_82772199的博客 1215

【鸿蒙软件开发】ArkTS容器组件之Badge

Badge组件:可以附加在单个组件上用于信息标记的容器组件。以上就是今天要讲的内容,本文介绍了Badge组件的使用,这个组件可以让用户快速得知信息数目,非常方便。

m0_62599305的博客 1726

鸿蒙5.0版开发:UI框架JS组件-容器组件(badge)

应用中如果有需用户关注的新事件提醒,可以采用新事件标记来标识。

m0_69424697的博客 546

Harmony OS Next应用开发进阶篇(二)-Scroll、Tabs、Badge

本文介绍了鸿蒙中的三个概念,分别是 Scroll、Tabs 和 Badge 。Scroll 用于实现内容超出屏幕时的滚动效果,方便用户查看更多信息;Tabs 是一种界面导航方式,通过划分不同标签页让用户轻松切换内容或操作;Badge 则用于在图标或组件上显示提示信息,如未读消息数量等。这些概念有助于提升鸿蒙应用的用户体验、交互性以及界面效果。

2401_88463044的博客 1940

鸿蒙5.0版开发:ArkTS组件-ComposeListItem

列表包含一系列相同宽度的列表项。

m0_69424697的博客 1173

DP_AUX辅助通道介绍

DisplayPort(简称DP)是一个由PC及芯片制造商联盟开发,视频电子标准协会(VESA)标准化的数字式视频接口标准。其中辅助通道(AUX)是一条独立双向半双工的传输通道,它也是一对差分信号线。其数据传输速率1Mbps,用来传输配置参数与指令。

cjie221的博客 5364

鸿蒙ArkTS | Badge 信息标记组件自学指南

Badge组件是HarmonyOS ArkUI中用于信息标记的容器组件,可附加在图标、按钮等元素上显示红点、数字或文本提示。它支持三种主要用法:空值显示红点、字符串显示文本标签(如"New")、数字显示数量(超过maxCount显示99+)。组件提供丰富的样式配置参数,包括大小、颜色、位置等,从API12开始还内置了缩放动画效果。Badge非常适合消息提醒、状态标记等场景,具有轻量易用、灵活配置的特点,是UI设计中提升交互感知的理想选择。

李游的博客 1289

GD32F103入门实践(一)配置环境,搭建工程模板,烧写程序

写在前面 本系列博客是我初学GD32F103的操作实录,我个人是个小白,在学习过程中真的也遇到了不少坑,因此我希望能记录下来,帮助到同样踩坑的你。 我的芯片是GD32F103ZE,软件是Keil,烧写用的是JLink。 材料准备 首先我在兆易创新官网(兆易创新),下载相关的文件。点击资料下载,在搜索框里输入“GD32F10”可以得到相关的资料,其他芯片类似。比较重要的是GD32F10x AddOn和GD32F10x Firmware Library(固件库),这两个必须下载。 下载Keil MDK5,这

qq_41208487的博客 3万+

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

列表包含一系列相同宽度的列表项。

Androidbye的博客 858

飞牛NAS挂载115网盘避坑指南:为什么你的大文件总是传输失败?

本文深入解析了在飞牛NAS上通过AList挂载115网盘时,大文件传输失败的深层原因,包括风控机制、网络协议及兼容性问题。文章提供了从基础排查到高阶优化的系统性解决方案,并建议采用Kopia分片备份等终极策略,以实现稳定可靠的云端数据流转。

weixin_29306011的博客 1699

Mac新手必看:为什么你的终端找不到Python命令?5分钟搞定zsh报错

本文针对Mac用户在终端遇到“zsh: command not found: python”报错的问题,提供了深度解析与实战修复指南。文章解释了macOS系统因历史原因默认使用`python3`而非`python`命令,并详细介绍了四种解决方案:养成使用`python3`的习惯、创建别名、通过Homebrew安装链接以及修改PATH环境变量,帮助新手快速解决zsh报错,顺利开始Python开发。

weixin_29248653的博客 598

HarmonyOS 6 Badge 标记组件使用示例文档

Badge(标记组件)是HarmonyOS ArkTS中用于在UI元素上展示角标、红点、数字/文本提示的容器组件,常用于消息提醒、状态标记等场景(如未读消息数、新功能提示、异常状态红点等)。本文基于示例代码,详细讲解Badge组件的核心使用方式。value与count互斥:Badge组件同时只能设置value(文本)或count(数字),不可同时设置;尺寸适配badgeSize需根据标记内容调整(如文本“New”需16px以上,红点可设6-8px);布局约束。

qq_37048082的博客 7658

间充质干细胞衰老机制与抗衰老干预策略研究

干细胞技术在再生医学领域具有广阔应用前景,其中间充质干细胞(MSCs)因其多向分化潜能和免疫调节特性备受关注。细胞衰老是影响干细胞治疗效果的共性难题,表现为增殖能力下降、端粒缩短等特征。通过表观遗传学分析发现,衰老MSCs存在DNA甲基化异常和组蛋白修饰改变;线粒体功能障碍导致ATP产量锐减,ROS累积显著增加。针对这些机制,研究者开发了包括小分子化合物筛选、CRISPR基因编辑和三维培养优化在内的多种干预策略。这些技术在组织修复、抗衰老治疗等应用场景中展现出重要价值,例如可提升心肌梗死修复效率2.3倍,缩

weixin_33502772的博客 231

【鸿蒙next开发】JS服务卡片UI组件:容器组件(badge)

鸿蒙HarmonyOS开发中的Badge组件详解,用于展示新事件提醒标记。

m0_73088370的博客 494

FPGA实战:MIG IP核AXI接口DDR3读写优化指南

本文详细解析了FPGA中MIG IP核AXI接口的DDR3读写优化策略,涵盖关键参数配置、突发传输技巧及时序收敛方案。通过AXI接口优化和突发长度选择,可实现高达12.8GB/s的理论带宽,提升DDR3访问效率。文章还提供了Vivado配置实例和调试技巧,助力开发者解决FPGA内存控制中的实际问题。

weixin_29168393的博客 548

JavaSwing_4.2: JDialog、JOptionPane(对话框)

JDialog,对话框。使用 JDialog 类可以创建自定义有的对话框,或者调用 JOptionPane 中的多个静态方法快速创建各种标准的对话框。JOptionPane是 JavaSwing 内部已实现好的,以静态方法的形式提供调用,能够快速方便的弹出要求用户提供值或向其发出通知的标准对话框。

谢TS的博客 7万+

HarmonyOS 6 Badge 组件自定义外描边和文本延伸方向使用示例文档

为 Badge 标记添加自定义样式的外描边(边框颜色、宽度);控制 Badge 文本超出标记尺寸时的自动避让(延伸)行为。通过交互按钮可切换文本避让开关状态,直观展示不同配置下的视觉效果,适用于需要个性化标记样式、适配长文本展示的场景(如多位数数字标记、自定义风格角标等)。// Badge 显示的文本内容(长文本用于测试延伸效果)// 文本避让开关状态列表// 切换状态的索引// 状态对应的文本展示值说明选择4位数字,超出 Badge 基础尺寸(30vp),可直观体现文本避让效果;

qq_37048082的博客 7697

基于Python的房地产评估数据抓取与分析 —— 房价走势与市场报告

在房地产行业中,了解和分析房产价格的变化趋势、各个地区的房价差异以及市场评价报告,可以帮助投资者、购房者以及政策制定者做出更加明智的决策。本文介绍了如何使用Python爬虫技术抓取房地产平台上的房产评估报告、价格走势等数据,并对抓取的数据进行分析。通过这些技术,您可以自动化抓取房地产平台的数据,分析房价走势,获取市场报告,为房地产投资决策提供数据支持。假设我们要从链家网抓取某个房产的价格、房产描述以及历史成交价格,首先需要获取目标房产页面的URL,并发送HTTP请求。伪装为常见浏览器,避免被识别为爬虫。

2201_76125261的博客 848

鸿蒙5.0开发进阶:ArkTS API UI界面(ArkUI)-BuilderNode

提供能够挂载原生组件的自定义节点BuilderNode。

Androidbye的博客 1230

jre9下载 jdk9

(Java SE Runtime Environment 9.0) 9.0u175 官方最新版 【x86|x64】

数学建模模型总结

这是本人在两年内准备参加数学建模竞赛搜集到的模型资料,已经经过了本人的筛选和整理,希望能够对准备参加数学建模竞赛的学弟学妹们提供一些帮助!

Stack 实现购物车角标鸿蒙 HarmonyOS ArkTS 原生学习

本文介绍了在HarmonyOS NEXT(API 24)中使用ArkTS实现购物车角标功能的技术方案。主要内容包括: 开发环境配置要求(DevEco Studio 5.1+、API 24) 核心组件详解: Stack布局容器的层叠特性与对齐控制 Badge角标组件的使用方法和定位方式 实现步骤: 通过Stack实现图标与角标的层叠 使用Badge组件创建动态更新的角标 结合@State实现购物车数量的响应式更新 文章提供了完整的代码示例和演示效果图,帮助开发者掌握ArkUI中常见的角标实现方式,适用于电商、

2301_79407951的博客 678

Statistics and Machine Learning Toolbox

Statistics and Machine Learning Toolbox(带书签),MATLAB统计学习工具

【精通篇】打造React Native鸿蒙跨平台开发高级复合组件库开发系列:基于HarmonyOS API 24 Badge 徽标(在右上角展示徽标数字或小红点)

Fetch API 提供了两种不太一样的方式用于创建Request 对象的副本:使用Request 构造函数和使。关键在于,通过fetch 使用Request 会将请求体标记为已使用。要想基于包含请求体的相同Request 对象多次调用fetch(),必须在第一次发送fetch()请求前。第二种克隆Request 对象的方式是使用clone()方法,这个方法会创建一模一样的副本,任何值。如果请求对象的bodyUsed 属性为true(即请求体已被读取),那么上述任何一种方式都不能用来。

wanmeijuhao的博客 374

迈瑞BS系列全自动生化分析仪LIS协议接口手册(内含HL7和ASTM)

迈瑞BS系列全自动生化分析仪LIS协议接口手册,内含HL7和ASTM)

HarmonyOS6 Badge 角标组件,5 分钟搞懂怎么用

做 App 的时候,消息数量提示这个需求几乎每个项目都有。我第一次在 HarmonyOS 上实现这个效果,翻了一圈文档才发现有个现成的Badge组件,直接包一下就行,省了自己叠Stack布局手撸的功夫。今天把常用的几种玩法整理一下,贴上真实代码,省得你再去翻文档了。实际项目里,设计师肯定不满足于默认样式。Badge 的styleBadge({style: {}) {.width(60)maxCount:超过这个数就显示99+,不设的话数字有多大显示多大badgeSize。

全栈若城,专注知识分享 1642

【共创季稿事节】鸿蒙原生 ArkTS 布局深度解析:Stack 实现圆角头像与角标

鸿蒙ArkTS布局:Stack实现圆角头像与角标 本文深入解析在HarmonyOS NEXT中使用ArkTS实现"圆形头像+状态角标"的三种技术方案: Badge组件方案 - 利用系统内置角标组件快速实现右上角状态指示,适合标准场景 Stack+Circle方案 - 通过Stack层叠布局和Circle组件手动定位,实现灵活的位置控制 自定义组件方案 - 封装可复用的StatusAvatar组件,支持不同尺寸和状态位置 核心要点包括: Stack布局的层叠特性与子组件定位方法 使用borderRadius实

zjxcq520的博客 597

HarmonyOS6 PC 端仪表盘首页综合布局实战:Banner + 统计 + 快捷入口 + 动态列表

学了那么多单个组件,是时候把它们组合到一起,搭一个完整的页面了。仪表盘首页是应用开发中最典型的综合页面之一:顶部是用户问候和通知区域,然后是大图 Banner,往下是统计数据块,接着是快捷入口网格,最后是最近动态列表。这套结构几乎出现在每一款 To-B 应用和个人数据管理应用里。本文把这个仪表盘首页从头到尾拆解一遍,重点讲三个新知识点:@Builder装饰器复用局部 UI、Badge消息角标组件、以及接口类型定义在 ArkTS 中的实际应用。这些是从"能写组件"到"能写完整页面"的关键跨越。@Entry。

qq_37048082的博客 5377

HarmonyOS ArkUI Badge 徽标与 Chip 标签:消息红点、数字徽标与可选中标签

系列:鸿蒙 HarmonyOS 6.1 新特性实战 · 第 39 篇Badge(徽标)用于在图标或按钮上附加消息计数、红点提醒或文字标记;Chip(标签)则用于展示可操作的关键词标签。本篇演示 Bad

weixin_57404083的博客 208

HarmonyOS7标签页徽章提醒实战:Badge 与 Tab 组件组合使用

把 Badge 放到 Tab 上,是很多应用里最真实的用法之一。因为它直接影响一级入口的信息分发方式。这个案例很适合理解导航入口和状态提示怎么共存。我一直觉得,好示例不一定代码多,但一定能把“为什么要这么写”交代清楚。标签页徽章提醒 这个页面就属于这种,值得停下来认真拆一遍。如果把这页当成练习材料,我会优先看它怎样围绕 Badge 与 Tab 组件组合使用 组织页面。因为这一层想清楚了,后面的代码基本就不会散。

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

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

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

抵扣说明:

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

余额充值