更新记录

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

支持与赞赏

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

支付宝赞助 微信赞助

隐私、权限声明

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

无

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

无

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

无

许可协议

MIT协议

暂无用户评论。