更新记录

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(常规问题,群友互助,作者可能在线)
  • ***(很少在线)
  • 插件市场评论区:回复不及时,仅适合不着急的留言反馈

支持与赞赏

如果你觉得本插件解决了你的问题,可以考虑支持作者:

支付宝赞助 微信赞助

隐私、权限声明

1. 本插件需要申请的系统权限列表:

无

2. 本插件采集的数据、发送的服务器地址、以及数据用途说明:

无

3. 本插件是否包含广告,如包含需详细说明广告表达方式、展示频率:

无

许可协议

MIT协议

暂无用户评论。