@ophiuchus/tag
v1.0.1
Published
### 引入
Downloads
2
Maintainers
Readme
Tag 标签
引入
import Vue from 'vue';
import Tag from '@ophiuchus/tag';
Vue.use(Tag);
代码演示
基础用法
通过 type
属性控制标签颜色。
<sf-tag type="primary">标签</sf-tag>
<sf-tag type="success">标签</sf-tag>
<sf-tag type="danger">标签</sf-tag>
<sf-tag type="warning">标签</sf-tag>
空心样式
设置 plain
属性设置为空心样式。
<sf-tag plain type="primary">标签</sf-tag>
圆角样式
通过 round
设置为圆角样式。
<sf-tag round type="primary">标签</sf-tag>
标记样式
通过 mark
设置为标记样式(半圆角)。
<sf-tag mark type="primary">标签</sf-tag>
可关闭标签
添加 closeable
属性表示标签是可关闭的,关闭标签时会触发 close
事件,在 close
事件中可以执行隐藏标签的逻辑。
<sf-tag v-if="show" closeable size="medium" type="primary" @close="close">
标签
</sf-tag>
export default {
data() {
return {
show: true,
};
},
methods: {
close() {
this.show = false;
},
},
};
标签大小
通过 size
属性调整标签大小。
<sf-tag type="primary">标签</sf-tag>
<sf-tag type="primary" size="medium">标签</sf-tag>
<sf-tag type="primary" size="large">标签</sf-tag>
自定义颜色
通过 color
和 text-color
属性设置标签颜色。
<sf-tag color="#7232dd">标签</sf-tag>
<sf-tag color="#ffe1e1" text-color="#ad0000">标签</sf-tag>
<sf-tag color="#7232dd" plain>标签</sf-tag>
API
Props
| 参数 | 说明 | 类型 | 默认值 |
| --- | --- | --- | --- |
| type | 类型,可选值为primary
success
danger
warning
| string | default
|
| size | 大小, 可选值为large
medium
| string | - |
| color | 标签颜色 | string | - |
| plain | 是否为空心样式 | boolean | false
|
| round | 是否为圆角样式 | boolean | false
|
| mark | 是否为标记样式 | boolean | false
|
| text-color | 文本颜色,优先级高于color
属性 | string | white
|
| closeable | 是否为可关闭标签 | boolean | false
|
Slots
| 名称 | 说明 | | ------- | ------------ | | default | 标签显示内容 |
Events
| 事件名 | 说明 | 回调参数 | | ------ | -------------- | -------------- | | click | 点击时触发 | event: Event | | close | 关闭标签时触发 | - |
样式变量
组件提供了下列 Less 变量,可用于自定义样式,使用方法请参考主题定制。
| 名称 | 默认值 | 描述 |
| --------------------------- | --------------------------- | ---- |
| @tag-padding | 0 @padding-base
| - |
| @tag-text-color | @white
| - |
| @tag-font-size | @font-size-sm
| - |
| @tag-border-radius | 2px
| - |
| @tag-line-height | 16px
| - |
| @tag-medium-padding | 2px 6px
| - |
| @tag-large-padding | @padding-base @padding-xs
| - |
| @tag-large-border-radius | @border-radius-md
| - |
| @tag-large-font-size | @font-size-md
| - |
| @tag-round-border-radius | @border-radius-max
| - |
| @tag-danger-color | @red
| - |
| @tag-primary-color | @blue
| - |
| @tag-success-color | @green
| - |
| @tag-warning-color | @orange
| - |
| @tag-default-color | @gray-6
| - |
| @tag-plain-background-color | @white
| - |