双端兼容 · 桌面 + 移动
Tag 标签
用于标记与分类的小标签:五种类型搭配 plain / light / dark 三种效果,支持自定义颜色、圆角、hit 边框与可关闭。整体可点击并 emit click,关闭图标点击会阻止冒泡并 emit close。
基础用法
type 决定语义色(默认 info),effect 决定填充方式:plain 透明底描边(默认)、light 浅色底、dark 实色底白字。
默认 info
主要
成功
警告
危险
primary light
primary dark
success light
success dark
warning light
danger dark
尺寸与形态
size 提供 small(默认,20px 高)/ default(24px)/ large(32px)三档;round 全圆角,hit 让边框加深为文字色,closable 显示关闭图标并 emit close 事件(组件本身不移除节点,删除逻辑由业务侧处理)。
small
default
large
圆角标签
可关闭
hit 边框
自定义颜色
color 传入任意颜色即可覆盖主题配色:plain 效果下仅描边与文字着色(背景透明),light / dark 效果下填充该色(dark 下文字为白色)。
自定义色
自定义深色
自定义浅色
组合形态
动态编辑标签
典型的标签管理场景:closable 加 @close 从数组移除,输入框加按钮向数组追加,v-for 渲染即可,组件不维护内部状态。
前端
组件库
Vue 3
点击选中
标签整体可点击(emit click),结合动态 type / effect 可实现单选筛选器之类的轻交互。
primary
success
warning
danger
当前选中:primary
API
Tag Props
| 参数 | 说明 | 类型 | 默认值 |
|---|---|---|---|
| type | 类型 | primary | success | info | warning | danger | info |
| size | 尺寸(传空字符串等价于 default) | small | default | large | small |
| effect | 显示效果 | dark | light | plain | plain |
| round | 圆角标签 | boolean | false |
| hit | 边框使用文字色 | boolean | false |
| closable | 显示关闭图标(点击 emit close,不自动移除节点) | boolean | false |
| disable-transitions | 禁用颜色过渡动画 | boolean | true |
| color | 自定义颜色(plain 下仅描边与文字着色,dark 下文字为白色) | string | — |
Tag Events
| 参数 | 说明 | 类型 | 默认值 |
|---|---|---|---|
| click | 点击标签本体时触发 | (e: MouseEvent) => void | — |
| close | 点击关闭图标时触发(已阻止冒泡,不会触发 click) | (e: MouseEvent) => void | — |
Tag Slots
| 参数 | 说明 | 类型 | 默认值 |
|---|---|---|---|
| default | 标签内容 | — | — |