zebra-ui基于uniapp,跨多端组件库
  • 2.x
  • 中文
开发指南
介绍
快速上手
进阶用法
常见问题
更新日志
贡献指南
国际化
基础组件
Button 按钮
Cell 单元格
ConfigProvider 全局配置
Icon 图标
Image 图片
Layout 布局
Popup 弹出层
Style 内置样式
Transition 动画
Toast 轻提示
表单组件
Area 省市区选择
Calendar 日历
Cascader 级联选择
Checkbox 复选框
DatePicker 日期选择
Field 输入框
Form 表单
NumberKeyboard 数字键盘
PasswordInput 密码输入框
Picker 选择器
PickerGroup 选择器组
Radio 单选框
Rate 评分
Search 搜索
Slider 滑块
Signature 签名
Stepper 步进器
Switch 开关
TimePicker 时间选择
Uploader 文件上传
反馈组件
ActionSheet 动作面板
Barrage 弹幕
Dialog 弹出框
DropdownMenu 下拉菜单
FloatingPanel 浮动面板
FloatingBubble 浮动气泡
Loading 加载
Notify 消息通知
Overlay 遮罩层
PullRefresh 下拉刷新
ShareSheet 分享面板
SwipeCell 滑动单元格
展示组件
Badge 徽标
Circle 环形进度条
Collapse 折叠面板
CountDown 倒计时
Divider 分割线
Empty 空状态
Highlight 高亮文本
List 列表
NoticeBar 通知栏
Popover 气泡弹出框
Progress 进度条
RollingText 翻滚文本
Skeleton 骨架屏
Steps 步骤条
Sticky 粘性布局
Swipe 轮播
Tag 标签
TextEllipsis 文本省略
Watermark 水印
导航组件
Grid 宫格
NavBar 导航栏
Sidebar 侧边导航
Tab 标签页
Tabbar 标签栏
TreeSelect 分类选择

Tag 标签

介绍

用于标记关键词和概括主要内容。

代码演示

基础用法

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

<z-tag type="primary">标签</z-tag>
<z-tag type="success">标签</z-tag>
<z-tag type="danger">标签</z-tag>
<z-tag type="warning">标签</z-tag>

空心样式

设置 plain 属性设置为空心样式。

<z-tag plain type="primary">标签</z-tag>

圆角样式

通过 round 设置为圆角样式。

<z-tag round type="primary">标签</z-tag>

标记样式

通过 mark 设置为标记样式(半圆角)。

<z-tag mark type="primary">标签</z-tag>

可关闭标签

添加 closeable 属性表示标签是可关闭的,关闭标签时会触发 close 事件,在 close 事件中可以执行隐藏标签的逻辑。

<z-tag :show="show" closeable size="medium" type="primary" @close="close">
  标签
</z-tag>
import { ref } from 'vue';
const show = ref(true);
const close = () => {
  show.value = false;
};

标签大小

通过 size 属性调整标签大小。

<z-tag type="primary">标签</z-tag>
<z-tag type="primary" size="medium">标签</z-tag>
<z-tag type="primary" size="large">标签</z-tag>

自定义颜色

通过 color 和 text-color 属性设置标签颜色。

<z-tag color="#7232dd">标签</z-tag>
<z-tag color="#ffe1e1" text-color="#ad0000">标签</z-tag>
<z-tag color="#7232dd" plain>标签</z-tag>

API

Props

参数说明类型默认值
type类型,可选值为 primary success danger warningstringdefault
size大小, 可选值为 large mediumstring-
color标签颜色string-
show是否展示标签booleantrue
plain是否为空心样式booleanfalse
round是否为圆角样式booleanfalse
mark是否为标记样式booleanfalse
text-color文本颜色,优先级高于 color 属性stringwhite
closeable是否为可关闭标签booleanfalse

Slots

名称说明
default标签显示内容

Events

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

主题定制

样式变量

组件提供了下列 CSS 变量,可用于自定义样式,使用方法请参考 ConfigProvider 组件。

名称默认值描述
--z-tag-padding0 var(--z-padding-base)-
--z-tag-text-colorvar(--z-white)-
--z-tag-font-sizevar(--z-font-size-sm)-
--z-tag-radius4rpx-
--z-tag-line-height32rpx-
--z-tag-medium-padding4rpx 12rpx-
--z-tag-large-paddingvar(--z-padding-base) var(--z-padding-xs)-
--z-tag-large-radiusvar(--z-radius-md)-
--z-tag-large-font-sizevar(--z-font-size-md)-
--z-tag-round-radiusvar(--z-radius-max)-
--z-tag-danger-colorvar(--z-danger-color)-
--z-tag-primary-colorvar(--z-primary-color)-
--z-tag-success-colorvar(--z-success-color)-
--z-tag-warning-colorvar(--z-warning-color)-
--z-tag-default-colorvar(--z-gray-6)-
--z-tag-plain-backgroundvar(--z-background-2)-