更新记录
1.0.0(2026-11-17) 下载此版本
新增
- 首次发布
- 标签组件,五类型(primary / success / warning / danger / info)× 三风格(light / solid / plain)自由组合
light浅底彩字基于「内部 absolute 铺色块 + opacity 0.12」实现,任意自定义颜色都有浅底效果shape三种形状:square 方角 / round 全胶囊 / mark 右侧全圆角(半圆角标签)size四档尺寸:mini / small / medium / large,字号与内边距成套color自定义颜色优先于 type 生效,三种风格均适配closable显示右侧关闭按钮并触发close事件(不自动隐藏),disabled半透明且点击无效
平台兼容性
uni-app(5.0)
| Vue2 | Vue3 | Chrome | Safari | app-vue | app-nvue | Android | iOS | 鸿蒙 |
|---|---|---|---|---|---|---|---|---|
| - | √ | √ | √ | √ | - | √ | √ | √ |
| 微信小程序 | 支付宝小程序 | 抖音小程序 | 百度小程序 | 快手小程序 | 京东小程序 | 鸿蒙元服务 | QQ小程序 | 飞书小程序 | 小红书小程序 | 快应用-华为 | 快应用-联盟 |
|---|---|---|---|---|---|---|---|---|---|---|---|
| √ | √ | √ | - | - | - | - | - | - | - | - | - |
ry-tag 标签
标签组件(uni-app / Vue3 版):五类型(primary / success / warning / danger / info)× 三风格(light 浅底彩字 / solid 实心白字 / plain 描边彩字)自由组合,方角 / 全胶囊 / 右半圆三种形状,四档尺寸成套。自定义颜色优先于 type 且三种风格均适配,支持关闭按钮与禁用态,一套 API 覆盖分类标记、状态标签、筛选条件、活动角标等场景。
需要 uni-app x(uvue)版本请使用 ry-tag-x。
安装
三种方式任选其一。
方式一:uni_modules 导入(推荐)
通过 HBuilderX 从插件市场导入 uni_modules,组件位于 uni_modules/ry-tag/components/ry-tag/ 下,easycom 自动注册,无需 import。
方式二:源码放到 components 目录
下载源码后,把组件放到项目的 components/ry-tag/ry-tag.vue,保持该目录结构,即符合 easycom 默认规则,自动注册。
方式三:手动导入
组件放在其他任意位置时,显式导入注册即可,与 easycom 不冲突(显式导入优先生效):
import ryTag from '@/components/ry-tag/ry-tag.vue'
使用示例
<template>
<!-- 1. 最简用法:浅底蓝标签 -->
<ry-tag>默认标签</ry-tag>
<!-- 2. 五类型 × 三风格 -->
<ry-tag type="success" effect="solid">成功</ry-tag>
<ry-tag type="warning" effect="plain">警示</ry-tag>
<ry-tag type="danger" effect="light">危险</ry-tag>
<!-- 3. 形状与尺寸 -->
<ry-tag shape="round">胶囊标签</ry-tag>
<ry-tag shape="mark">半圆角标签</ry-tag>
<ry-tag size="large">大号标签</ry-tag>
<!-- 4. 自定义颜色(优先于 type,三种风格均适配) -->
<ry-tag color="#8b5cf6">紫色标签</ry-tag>
<ry-tag color="#8b5cf6" effect="solid">紫色实心</ry-tag>
<!-- 5. 可关闭与禁用 -->
<ry-tag closable @close="onClose">可关闭</ry-tag>
<ry-tag :disabled="true">禁用标签</ry-tag>
</template>
<script setup>
const onClose = () => {
// close 事件不会自动隐藏,由外部自行处理
}
</script>
API
Props
| 属性 | 类型 | 默认值 | 说明 |
|---|---|---|---|
| type | String | 'primary' | 类型:primary / success / warning / danger / info |
| effect | String | 'light' | 风格:light 浅底彩字 / solid 实心白字 / plain 透明底描边彩字 |
| shape | String | 'square' | 形状:square 方角(8rpx 圆角)/ round 全胶囊 / mark 右侧全圆角 |
| size | String | 'medium' | 尺寸:mini / small / medium / large 四档字号与内边距(20/22/26/30rpx) |
| color | String | '' | 自定义颜色,优先于 type 生效 |
| closable | Boolean | false | 是否显示右侧关闭按钮(仅触发 close 事件,不自动隐藏) |
| disabled | Boolean | false | 禁用态:半透明(opacity 0.5)且点击无效 |
Events
| 事件名 | 说明 | 回调参数 |
|---|---|---|
| click | 点击标签时触发(disabled 时不触发) | — |
| close | 点击关闭按钮时触发(disabled 时不触发,不自动隐藏) | — |
Slots
| 名称 | 说明 |
|---|---|
| default | 标签文字内容 |
风格说明
- light(默认):浅底彩字。内部第一个子元素为 absolute 铺满色块(背景色 = 颜色、opacity 0.12),文字
position: relative保证在色块上方 —— 任意自定义颜色都有浅底效果 - solid:实心白字,背景 = 颜色
- plain:透明底描边彩字,2rpx 边框 = 颜色
实现说明
三种形状由 border-radius 切换(8rpx / 999rpx / 0 999rpx 999rpx 0),浅底色块通过 border-radius: inherit 跟随形状;关闭按钮基于文本 × 实现,无图标字体、图片依赖,全端(H5 / 小程序 / App)表现一致。
技术支持
- 微信:howe1144(一定在线,紧急问题首选)
- QQ 群:415367029(常规问题,群友互助,作者可能在线)
- ***(很少在线)
- 插件市场评论区:回复不及时,仅适合不着急的留言反馈
支持与赞赏
如果你觉得本插件解决了你的问题,可以考虑支持作者:
| 支付宝赞助 | 微信赞助 |
|---|---|
![]() |
![]() |

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


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