更新记录

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

支持与赞赏

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

支付宝赞助 微信赞助

隐私、权限声明

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

无

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

无

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

无

许可协议

MIT协议

暂无用户评论。