更新记录
1.0.0(2026-11-17) 下载此版本
新增
- 首次发布
- 徽标组件(uni-app x / uvue 版),支持红点 / 数字角标 / 文字徽标三种形态
absolute包裹任意内容叠加右上角角标,offsetX/offsetY偏移微调(rpx);false 时为独立胶囊- 数字超过
max自动显示「{max}+」,showZero控制 0 值显隐 text支持文字徽标(如 NEW / HOT),dot圆点模式,color直接配色- 点击触发
click事件,圆点基于纯 CSS 实现,无图标 / 图片依赖,兼容 App-Android / iOS / 鸿蒙
平台兼容性
uni-app x(5.0)
| Chrome | Safari | Android | iOS | 鸿蒙 | 微信小程序 |
|---|---|---|---|---|---|
| √ | √ | √ | √ | √ | √ |
ry-badge-x 徽标(uni-app x)
徽标组件(uni-app x / uvue 版):红点 / 数字角标 / 文字徽标三合一,支持 absolute 包裹任意内容叠加右上角角标(偏移可微调)与独立胶囊两种形态。数字超过 max 自动显示「{max}+」,0 值显隐可配,背景色自由指定,一套 API 覆盖消息数、购物车数量、活动标记、状态提示等场景。
需要 uni-app(Vue3)版本请使用 ry-badge。
安装
三种方式任选其一。
方式一:uni_modules 导入(推荐)
通过 HBuilderX 从插件市场导入 uni_modules,组件位于 uni_modules/ry-badge-x/components/ry-badge/ 下,easycom 自动注册,无需 import。
方式二:源码放到 components 目录
下载源码后,把组件放到项目的 components/ry-badge/ry-badge.uvue,保持该目录结构,即符合 easycom 默认规则,uni-app x 自动注册。
方式三:手动导入
组件放在其他任意位置时,显式导入注册即可,与 easycom 不冲突(显式导入优先生效):
import ryBadge from '@/components/ry-badge/ry-badge.uvue'
使用示例
<template>
<!-- 1. 包裹内容叠加:数字角标 -->
<ry-badge :value="8" :absolute="true">
<view class="icon"><text>消息</text></view>
</ry-badge>
<!-- 2. 红点模式(忽略 value / text) -->
<ry-badge :absolute="true" :dot="true">
<view class="icon"><text>待办</text></view>
</ry-badge>
<!-- 3. 文字徽标 -->
<ry-badge :absolute="true" text="NEW" color="#ff9f2e">
<view class="icon"><text>活动</text></view>
</ry-badge>
<!-- 4. 超限显示 99+ 与偏移微调 -->
<ry-badge :absolute="true" :value="120" :max="99" :offset-x="6" :offset-y="-6">
<view class="icon"><text>购物车</text></view>
</ry-badge>
<!-- 5. 独立胶囊 -->
<ry-badge :value="5"></ry-badge>
<ry-badge text="HOT" color="#07c160"></ry-badge>
<!-- 6. 点击事件 -->
<ry-badge :value="3" :absolute="true" @click="onClick">
<view class="icon"><text>铃铛</text></view>
</ry-badge>
</template>
<script setup lang="uts">
const onClick = () => {
console.log('badge click')
}
</script>
API
Props
| 属性 | 类型 | 默认值 | 说明 |
|---|---|---|---|
| value | Number | 0 | 数字角标值,超过 max 显示「{max}+」 |
| max | Number | 99 | 数字上限,超过后显示「{max}+」 |
| dot | Boolean | false | 圆点模式(忽略 value / text) |
| text | String | '' | 文字徽标内容,如 NEW / HOT |
| color | String | '#ff4d4f' | 徽标背景颜色 |
| absolute | Boolean | false | 是否叠加到 slot 内容右上角,false 为独立胶囊 |
| offsetX | Number | 0 | absolute 模式水平偏移(rpx,正值向右) |
| offsetY | Number | 0 | absolute 模式垂直偏移(rpx,正值向下) |
| showZero | Boolean | false | 数字为 0 时是否显示 |
Events
| 事件名 | 说明 | 回调参数 |
|---|---|---|
| click | 点击徽标(或包裹内容)时触发 | — |
Slots
| 名称 | 说明 |
|---|---|
| default | absolute 模式下被徽标包裹的内容 |
显示逻辑
dot圆点模式与text文字模式直接渲染,不受数字显隐规则影响- 数字模式:
value > 0渲染;value <= 0且未开启showZero时不渲染徽标 value超过max显示「{max}+」,负数按 0 处理
实现说明
圆点与胶囊均为纯 CSS 实现(16rpx 圆点 / 999rpx 全圆角胶囊),无图标字体、图片依赖;叠加模式基于 position: absolute 钉在包裹内容右上角,offsetX / offsetY 通过 right / top 动态换算偏移。uvue 不支持 inline-flex,独立胶囊形态改用 flex 自适应宽度,App-Android / iOS / 鸿蒙 / Web / 小程序表现一致。
技术支持
- 微信:howe1144(一定在线,紧急问题首选)
- QQ 群:415367029(常规问题,群友互助,作者可能在线)
- ***(很少在线)
- 插件市场评论区:回复不及时,仅适合不着急的留言反馈
支持与赞赏
如果你觉得本插件解决了你的问题,可以考虑支持作者:
| 支付宝赞助 | 微信赞助 |
|---|---|
![]() |
![]() |

收藏人数:
下载插件并导入HBuilderX
赞赏(0)


下载 3
赞赏 0
下载 12771027
赞赏 1959
赞赏
京公网安备:11010802035340号