更新记录
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 工程中使用。
- 将
LJJ2024-tag目录放入工程的uni_modules/下; - 在页面中按示例引用组件;
- 运行外层工程到浏览器 / 小程序 / App 验证;
- 可参考
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 生成)

收藏人数:
下载插件并导入HBuilderX
下载插件ZIP
赞赏(0)
下载 1
赞赏 0
下载 12775795
赞赏 1960
赞赏
京公网安备:11010802035340号