更新记录

0.0.8(2025-09-04) 下载此版本

  • fix: 修复切换type 文字颜色不生效问题

0.0.7(2025-06-11) 下载此版本

  • fix: 修复无法自定义文本颜色

0.0.6(2025-04-22) 下载此版本

  • feat: 兼容uniappx 鸿蒙next
查看更多

平台兼容性

uni-app(4.44)

Vue2 Vue3 Chrome Safari app-vue app-nvue Android iOS 鸿蒙
- 5.0
微信小程序 支付宝小程序 抖音小程序 百度小程序 快手小程序 京东小程序 鸿蒙元服务 QQ小程序 飞书小程序 快应用-华为 快应用-联盟
- - - - - - - - -

uni-app x(4.61)

Chrome Safari Android iOS 鸿蒙 微信小程序
5.0

lime-tag 标签组件

一个功能丰富的标签组件,用于标记和分类。支持多种形状、尺寸、颜色和风格变体,可用于标记状态、分类、提示等多种场景。组件提供了丰富的自定义选项,可以满足各种复杂的界面设计需求。

插件依赖:lime-sharedlime-style

文档链接

📚 组件详细文档请访问以下站点:

安装方法

  1. 在uni-app插件市场中搜索并导入lime-tag
  2. 导入后可能需要重新编译项目
  3. 在页面中使用l-tag组件

::: tip 注意🔔 本插件依赖的【lime-svg】是原生插件,如果购买(收费为6元)则需要自定义基座,才能使用, 若不需要删除即可 :::

代码演示

标签主题

通过 type 属性控制标签颜色。

<l-tag type="primary">品牌色</l-tag>
<l-tag type="success">成功色</l-tag>
<l-tag type="warning">警告色</l-tag>
<l-tag type="danger">危险色</l-tag>
<l-tag>通用色</l-tag>

标签形状

通过 shape 属性控制标签形状。

<l-tag shape="square" type="primary">方形</l-tag>
<l-tag shape="round" type="success">圆角</l-tag>
<l-tag shape="mark" type="primary">半圆</l-tag>

标签变种

通过variant 属性控制标签图标。

<l-tag variant="light">高亮</l-tag>
<l-tag variant="light" type="primary">品牌</l-tag>
<l-tag variant="light" type="success">成功</l-tag>
<l-tag variant="light" type="warning">警告</l-tag>
<l-tag variant="light" type="danger">危险</l-tag>

<l-tag>深色</l-tag>
<l-tag type="primary">品牌</l-tag>
<l-tag type="success">成功</l-tag>
<l-tag type="warning">警告</l-tag>
<l-tag type="danger">危险</l-tag>

<l-tag variant="outline">描边</l-tag>
<l-tag variant="outline" type="primary">品牌</l-tag>
<l-tag variant="outline" type="success">成功</l-tag>
<l-tag variant="outline" type="warning">警告</l-tag>
<l-tag variant="outline" type="danger">危险</l-tag>

<l-tag variant="light-outline">光廓</l-tag>
<l-tag variant="light-outline" type="primary">品牌</l-tag>
<l-tag variant="light-outline" type="success">成功</l-tag>
<l-tag variant="light-outline" type="warning">警告</l-tag>
<l-tag variant="light-outline" type="danger">危险</l-tag>

标签图标

通过icon 属性控制标签图标。

<l-tag icon="face-retouching" type="primary">标签</l-tag>
<l-tag icon="filter-3" variant="light">标签</l-tag>
<l-tag icon="markup" variant="outline">标签</l-tag>

标签尺寸

通过 size 属性控制标签大小。

<l-tag size="mini" type="primary">细</l-tag>
<l-tag size="small" type="primary">小</l-tag>
<l-tag size="medium" type="primary">中</l-tag>
<l-tag size="large" type="warning">大</l-tag>
<l-tag size="extra-large" type="primary">加大</l-tag>

超长文本省略标签

通过max-width 属性,当内容超过时显示省略号。

<l-tag max-width="130px" variant="light">听说超长可以省略听说超长</l-tag>

自定义颜色

通过 color 属性设置标签颜色,。

<l-tag color="#7232dd" icon="face-retouching">标签</l-tag>
<l-tag color="linear-gradient(to right, rgb(255, 96, 52), rgb(238, 10, 36))" icon="filter-3">标签</l-tag>
<l-tag color="#7232dd" icon="markup" variant="outline">标签</l-tag>

可关标签

通过 closable 属性设置标签可关闭,通过 @close事件接收关闭事件。

<l-tag v-if="show1" @close="show1 = false" :closable="true" icon="face-retouching" type="primary">标签</l-tag>
<l-tag v-if="show2" @close="show2 = false" :closable="true" icon="filter-3" variant="light">标签</l-tag>
<l-tag v-if="show3" @close="show3 = false" :closable="true" icon="markup" variant="outline">标签</l-tag>

快速预览

导入插件后,可以直接使用以下标签查看演示效果:

<!-- 代码位于 uni_modules/lime-tag/components/lime-tag -->
<lime-tag />

插件标签说明

标签名 说明
l-tag 组件标签
lime-tag 演示标签

Vue2使用说明

main.js中添加以下代码:

// vue2项目中使用
import Vue from 'vue'
import VueCompositionAPI from '@vue/composition-api'
Vue.use(VueCompositionAPI)

详细配置请参考官方文档:Vue Composition API

API文档

Props 属性说明

属性名 说明 类型 默认值
content 标签内容 string -
type 标签类型,可选值为 default primary success warning danger string default
shape 标签形状,可选值为 square round mark string square
size 标签尺寸,可选值为 mini small medium large extra-large string medium
variant 标签风格变体,可选值为 solid light outline light-outline string solid
closable 是否可关闭 boolean false
disabled 是否禁用 boolean false
icon 标签中的图标,icon string -
prefix 前缀 string -
maxWidth 标签最大宽度,超出后显示省略号 string -
color 自定义标签颜色 string -
textColor 自定义文字颜色 string -
fontSize 自定义文字大小 string -
radius 自定义圆角大小 string -
padding 自定义内边距 string -

Events 事件

事件名 说明 回调参数
click 点击标签时触发 event: Event
close 关闭标签时触发 event: Event

Slots 插槽

名称 说明
default 标签内容
icon 自定义图标

主题定制

组件提供了以下CSS变量,可用于自定义样式:

变量名称 默认值 描述
--tag-solid-text-color white 实心标签文字颜色
--tag-default-solid-text-color white 默认实心标签文字颜色
--tag-border-radius $border-radius-sm 方形标签圆角大小
--tag-mark-border-radius $tag-round-border-radius 标记型标签圆角大小
--tag-close-icon-color $text-color-3 关闭图标颜色
--tag-default-color $gray-11 默认标签颜色
--tag-default-light-color $gray-1 默认浅色标签颜色
--tag-default-border-color $gray-5 默认标签边框颜色
--tag-primary-color $primary-color 主要标签颜色
--tag-primary-light-color $primary-color-1 主要浅色标签颜色
--tag-success-color $success-color 成功标签颜色
--tag-success-light-color $success-color-1 成功浅色标签颜色
--tag-warning-color $warning-color 警告标签颜色
--tag-warning-light-color $warning-color-1 警告浅色标签颜色
--tag-danger-color $error-color 危险标签颜色
--tag-danger-light-color $error-color-1 危险浅色标签颜色
--tag-mini-padding-x 4px 迷你标签水平内边距
--tag-mini-padding-y 0 迷你标签垂直内边距
--tag-mini-font-size 9px 迷你标签字体大小
--tag-mini-icon-size 10px 迷你标签图标大小
--tag-mini-height 15px 迷你标签高度
--tag-small-padding-x 6px 小型标签水平内边距
--tag-small-padding-y 0 小型标签垂直内边距
--tag-small-font-size $font-size-xs 小型标签字体大小
--tag-small-icon-size 12px 小型标签图标大小
--tag-small-height 20px 小型标签高度
--tag-medium-padding-x 8px 中型标签水平内边距
--tag-medium-padding-y 0 中型标签垂直内边距
--tag-medium-font-size $font-size-sm 中型标签字体大小
--tag-medium-icon-size 14px 中型标签图标大小
--tag-medium-height 24px 中型标签高度
--tag-large-padding-x 8px 大型标签水平内边距
--tag-large-padding-y 0 大型标签垂直内边距
--tag-large-font-size $font-size 大型标签字体大小
--tag-large-icon-size 16px 大型标签图标大小
--tag-large-height 28px 大型标签高度
--tag-extra-large-padding-x 15px 超大标签水平内边距
--tag-extra-large-padding-y 0 超大标签垂直内边距
--tag-extra-large-font-size $font-size 超大标签字体大小
--tag-extra-large-icon-size 16px 超大标签图标大小
--tag-extra-large-height 40px 超大标签高度

支持与赞赏

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

支付宝赞助 微信赞助

隐私、权限声明

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

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

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

许可协议

MIT协议