更新记录

1.0.0(2026-11-19) 下载此版本

2026.11.19


平台兼容性

uni-app x(4.66)

Chrome Safari Android iOS 鸿蒙 微信小程序
√ - √ - - -

LJJ2024-tag 标签组件 · 使用说明

组件名:LJJ2024-tag 作者ID:LJJ2024 插件ID:LJJ2024-tag 版本:1.0.0 基于 DCloud 官方 uni-tag 二次改造,仅供课程作业学习使用。


一、插件简介

LJJ2024-tag 是一个文字标签组件,用于展示一个或多个标签,支持点击选中/取消、空心、圆角、禁用、可关闭标签,以及自定义文字、背景、边框颜色。

相对官方 uni-tag 的改造点:

改造点 说明
去除 SCSS 依赖 原组件依赖 uni-scss,本插件样式改写为普通 CSS,可独立发布、零三方依赖
新增 closable 是否显示关闭按钮
新增 close 事件 点击关闭按钮触发,回传标签内容
新增自定义颜色 color / background / borderColor 覆盖类型默认色
修复空值显示 内容为数字 0 或空串时的显示判断更严谨
组件标识重命名 目录名、文件名、name 统一为 LJJ2024-tag / LJJ2024Tag,作者标注 @author LJJ2024

二、目录结构

将本目录整体放入 uni-app 工程的 uni_modules/ 下:

your-project/
└── uni_modules/
    └── LJJ2024-tag/
        ├── components/
        │   └── LJJ2024-tag/
        │       └── LJJ2024-tag.vue
        ├── example/
        │   └── LJJ2024-tag-demo.vue
        ├── package.json
        ├── readme.md
        ├── changelog.md
        └── 插件使用说明.md

遵循 uni_modules 规范,放入后无需手动 import、无需注册,可直接使用。


三、快速上手

3.1 基础用法

<template>
  <view>
    <LJJ2024-tag text="默认标签" />
    <LJJ2024-tag text="主要" type="primary" />
    <LJJ2024-tag text="成功" type="success" />
    <LJJ2024-tag text="警告" type="warning" />
    <LJJ2024-tag text="错误" type="error" />
  </view>
</template>

3.2 形态组合

<!-- 圆角空心 -->
<LJJ2024-tag text="圆角空心" type="primary" :circle="true" :inverted="true" />

<!-- 禁用 -->
<LJJ2024-tag text="禁用" type="warning" :disabled="true" />

<!-- 标记样式 -->
<LJJ2024-tag text="标记" type="error" :mark="true" />

<!-- 可关闭标签组 -->
<LJJ2024-tag
  v-for="(item, index) in tags"
  :key="index"
  :text="item"
  type="primary"
  closable
  @close="onClose"
/>
export default {
  data() {
    return { tags: ['标签一', '标签二', '标签三'] };
  },
  methods: {
    onClose(text) {
      this.tags = this.tags.filter((item) => item !== text);
    }
  }
}

3.3 自定义颜色

<LJJ2024-tag
  text="紫色标签"
  color="#ffffff"
  background="#7c3aed"
  border-color="#7c3aed"
/>

四、属性(Props)

属性名 类型 默认值 说明
text String / Number '' 标签内容
size String normal 尺寸:default / small / mini
type String default 颜色类型:default / primary / success / warning / error
disabled Boolean / String false 是否禁用
inverted Boolean / String false 是否空心(无背景色)
circle Boolean / String false 是否圆角
mark Boolean / String false 是否标记样式(左直角、右圆角)
closable Boolean / String false 是否显示关闭按钮
color String '' 自定义文字颜色(优先级高于 type)
background String '' 自定义背景颜色(优先级高于 type)
borderColor String '' 自定义边框颜色
customStyle String '' 追加的自定义内联样式,如 "padding: 0 10px; margin: 4px;"

布尔型属性可传布尔值,也可传字符串 "true" / "false",组件内部已兼容判断。


五、事件(Events)

事件名 回调参数 说明
click — 点击标签触发(禁用状态不触发)
close (text: String/Number) 点击关闭按钮触发,参数为标签内容

六、平台兼容性

App(vue) App(nvue) H5 微信小程序 支付宝小程序 百度小程序 字节小程序 QQ 小程序
√ √ √ √ √ √ √ √
Vue 版本 Vue2 Vue3
支持 √ √

七、运行与自测

注意:插件目录本身不是独立工程,不能单独编译运行,否则会报"缺少 pages.json 文件"。请在完整 uni-app 工程中使用。

  1. 将 LJJ2024-tag 目录放入工程的 uni_modules/ 下;
  2. 在页面中按示例引用组件;
  3. 运行外层工程到浏览器 / 小程序 / App 验证;
  4. 可参考 example/LJJ2024-tag-demo.vue 演示页面。

八、常见问题

1. 运行报"缺少 pages.json 文件,编译失败"

你直接运行了插件目录。请打开外层 uni-app 工程目录运行;插件目录仅用于右键「发布到插件市场」。

2. 提示插件 ID 已被占用

将插件 ID 改为带后缀的名称,例如 LJJ2024-tag-pro,并同步修改目录名、组件目录名、package.json 的 id。

3. 如何替换为自己的作者 ID

全局替换 LJJ2024 为本人姓名拼音简写 + 2024(例:张三 → ZS2024),保持目录名、package.json 的 id、组件名三处一致。


九、版权说明

本插件基于 DCloud 官方开源组件 uni-tag 二次修改,原组件仓库:https://github.com/dcloudio/uni-ui。 原插件市场地址:https://ext.dcloud.net.cn/plugin?id=35。 本文档与改造代码仅供课程作业学习使用。

(注:部分内容由豆包 AI 生成)

隐私、权限声明

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

无

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

无

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

无

许可协议

MIT协议

暂无用户评论。