更新记录
1.0.0(2026-11-17) 下载此版本
新增
- 首次发布
- 标签组件(uni-app x / uvue 版),五类型 primary / success / warning / danger / info
- 三风格 light 浅底彩字 / solid 实心白字 / plain 透明底描边彩字
- 三形状 square 方角 / round 全胶囊 / mark 右侧全圆角,四尺寸 mini / small / medium / large
color自定义颜色优先于type,三种风格均适配;light 基于 absolute 色块 + opacity 0.12,任意颜色都有浅底效果closable关闭按钮仅触发close事件(不自动隐藏),disabled半透明且 click / close 均不触发- 纯 CSS 实现无渐变 / 无动画,App-Android / iOS / 鸿蒙 / Web / 小程序表现一致
平台兼容性
uni-app x(5.0)
| Chrome | Safari | Android | iOS | 鸿蒙 | 微信小程序 |
|---|---|---|---|---|---|
| √ | √ | √ | √ | √ | √ |
ry-tag-x 标签(uni-app x)
标签组件(uni-app x / uvue 版):五类型 × 三风格 × 三形状 × 四尺寸,覆盖「状态标记 / 分类筛选 / 关键词 / 活动标签」等场景。color 可完全自定义颜色,closable 可关闭,disabled 禁用态,light 模式对任意颜色都有浅底效果。
需要 uni-app(Vue3)版本请使用 ry-tag。
安装
三种方式任选其一。
方式一:uni_modules 导入(推荐)
通过 HBuilderX 从插件市场导入 uni_modules,组件位于 uni_modules/ry-tag-x/components/ry-tag/ 下,easycom 自动注册,无需 import。
方式二:源码放到 components 目录
下载源码后,把组件放到项目的 components/ry-tag/ry-tag.uvue,保持该目录结构,即符合 easycom 默认规则,uni-app x 自动注册。
方式三:手动导入
组件放在其他任意位置时,显式导入注册即可,与 easycom 不冲突(显式导入优先生效):
import ryTag from '@/components/ry-tag/ry-tag.uvue'
使用示例
<template>
<!-- 1. 五类型(默认 light 浅底彩字) -->
<ry-tag type="primary"><text>主要</text></ry-tag>
<ry-tag type="success"><text>成功</text></ry-tag>
<ry-tag type="warning"><text>警告</text></ry-tag>
<ry-tag type="danger"><text>危险</text></ry-tag>
<ry-tag type="info"><text>信息</text></ry-tag>
<!-- 2. 三风格 -->
<ry-tag type="primary" effect="solid"><text>实心</text></ry-tag>
<ry-tag type="primary" effect="plain"><text>描边</text></ry-tag>
<!-- 3. 形状与尺寸 -->
<ry-tag shape="round" size="small"><text>小胶囊</text></ry-tag>
<ry-tag shape="mark" size="large"><text>右侧半圆</text></ry-tag>
<!-- 4. 自定义颜色 -->
<ry-tag color="#8b5cf6"><text>紫色浅底</text></ry-tag>
<ry-tag color="#14b8a6" effect="solid"><text>青色实心</text></ry-tag>
<!-- 5. 可关闭 / 禁用 -->
<ry-tag :closable="true" @close="onClose"><text>可关闭</text></ry-tag>
<ry-tag :disabled="true"><text>禁用</text></ry-tag>
</template>
<script setup lang="uts">
const onClose = () => {
console.log('tag close')
}
</script>
API
Props
| 属性 | 类型 | 默认值 | 说明 |
|---|---|---|---|
| type | String | 'primary' | 类型:primary / success / warning / danger / info |
| effect | String | 'light' | 风格:light 浅底彩字 / solid 实心白字 / plain 透明底描边彩字 |
| shape | String | 'square' | 形状:square 方角 / round 全胶囊 / mark 右侧全圆角 |
| size | String | 'medium' | 尺寸:mini / small / medium / large |
| color | String | '' | 自定义颜色,优先于 type 生效 |
| closable | Boolean | false | 是否显示右侧关闭按钮(仅触发 close 事件,不自动隐藏) |
| disabled | Boolean | false | 禁用态:半透明且点击无效 |
Events
| 事件名 | 说明 | 回调参数 |
|---|---|---|
| click | 点击标签时触发(disabled 时不触发) | — |
| close | 点击关闭按钮时触发(disabled 时不触发) | — |
Slots
| 名称 | 说明 |
|---|---|
| default | 标签文字内容 |
颜色映射
| type | 颜色 |
|---|---|
| primary | #2f6bff |
| success | #07c160 |
| warning | #ff9f2e |
| danger | #ff4d4f |
| info | #909399 |
实现说明
light 风格使用 absolute 色块铺满标签并设 opacity: 0.12,因此任意自定义颜色都能得到自然的浅底效果,无需维护 rgba 映射;solid / plain 分别用背景色与描边实现。形状通过纯 CSS 圆角区分(mark 为左侧直角 + 右侧全圆角),无渐变、无动画,App-Android / iOS / 鸿蒙 / Web / 小程序表现一致。
uvue 的文本样式不继承,插槽内若使用
<text>包裹文字,请在该<text>上自行设置字号与颜色。
技术支持
- 微信:howe1144(一定在线,紧急问题首选)
- QQ 群:415367029(常规问题,群友互助,作者可能在线)
- ***(很少在线)
- 插件市场评论区:回复不及时,仅适合不着急的留言反馈
支持与赞赏
如果你觉得本插件解决了你的问题,可以考虑支持作者:
| 支付宝赞助 | 微信赞助 |
|---|---|
![]() |
![]() |

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


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