更新记录
1.0.0(2025-03-21)
下载此版本
发布初版
平台兼容性
App |
快应用 |
微信小程序 |
支付宝小程序 |
百度小程序 |
字节小程序 |
QQ小程序 |
app-vue |
× |
√ |
× |
× |
× |
× |
钉钉小程序 |
快手小程序 |
飞书小程序 |
京东小程序 |
鸿蒙元服务 |
× |
× |
× |
× |
× |
H5-Safari |
Android Browser |
微信浏览器(Android) |
QQ浏览器(Android) |
Chrome |
IE |
Edge |
Firefox |
PC-Safari |
√ |
√ |
√ |
√ |
√ |
√ |
√ |
√ |
√ |
Tag 标签
组件名: xt-tag
适配情况需自行尝试,开发时只测试了 H5、APP、微信小程序
安装方式
本组件符合 easycom 规范,HBuilderX 3.1.0 起,只需将本组件导入项目,在页面 template 中即可直接使用,无需在页面中 import 和注册 components
注意事项
如何阻止事件冒泡
vue2:在组件上直接使用@click.native.stop
,如:<xt-icon @click.native.stop='click'></xt-icon>
;
vue3:由于 vue3 没有native
修饰符,所以不能直接在组件上使用.stop
修饰符,只能嵌套一层view
标签,在外层view
上添加@click.stop
阻止冒泡
基本用法
<template>
<view class="xt">
<view>
<view>基础使用</view>
<view style="display: flex; gap: 20rpx; margin-top: 10rpx">
<xt-tag @click="log" name="1">标签1</xt-tag>
<xt-tag bgColor="#67C23A">标签2</xt-tag>
<xt-tag bgColor="#909399">标签3</xt-tag>
<xt-tag bgColor="#E6A23C">标签4</xt-tag>
<xt-tag bgColor="#F56C6C">标签5</xt-tag>
</view>
</view>
<view>
<view>可关闭</view>
<view style="display: flex; gap: 20rpx; margin-top: 10rpx">
<xt-tag @close="close" name="1" closable>标签1</xt-tag>
<xt-tag closable bgColor="#67C23A">标签2</xt-tag>
<xt-tag closable bgColor="#909399">标签3</xt-tag>
<xt-tag closable bgColor="#E6A23C">标签4</xt-tag>
<xt-tag closable bgColor="#F56C6C">标签5</xt-tag>
</view>
</view>
<view>
<view>镂空</view>
<view style="display: flex; gap: 20rpx; margin-top: 10rpx">
<xt-tag plain>标签1</xt-tag>
<xt-tag plain bgColor="#67C23A">标签2</xt-tag>
<xt-tag plain bgColor="#909399">标签3</xt-tag>
<xt-tag plain bgColor="#E6A23C">标签4</xt-tag>
<xt-tag plain bgColor="#F56C6C">标签5</xt-tag>
</view>
</view>
<view>
<view>镂空并填充背景色</view>
<view style="display: flex; gap: 20rpx; margin-top: 10rpx">
<xt-tag plain plainFill>标签1</xt-tag>
<xt-tag plain plainFill bgColor="#67C23A">标签2</xt-tag>
<xt-tag plain plainFill bgColor="#909399">标签3</xt-tag>
<xt-tag plain plainFill bgColor="#E6A23C">标签4</xt-tag>
<xt-tag plain plainFill bgColor="#F56C6C">标签5</xt-tag>
</view>
</view>
<view>
<view>前后插槽</view>
<view style="display: flex; gap: 20rpx; margin-top: 10rpx">
<xt-tag bgColor="#67C23A">
<template #left>
<xt-icon size="30rpx" name="xt-icon-shaixuan"></xt-icon>
</template>
标签1
</xt-tag>
<xt-tag bgColor="#909399">
<template #left>
<xt-icon size="30rpx"></xt-icon>
</template>
标签2
<template #right>
<xt-icon size="30rpx" name="xt-icon-aixin1"></xt-icon>
</template>
</xt-tag>
<xt-tag bgColor="#E6A23C">
标签3
<template #right>
<xt-icon size="30rpx" name="xt-icon-xiaoshi1"></xt-icon>
</template>
</xt-tag>
</view>
</view>
<view>
<view>自定义大小</view>
<view style="display: flex; gap: 20rpx; margin-top: 10rpx">
<xt-tag size="26rpx">标签1</xt-tag>
<xt-tag bgColor="#67C23A">标签2</xt-tag>
<xt-tag size="36rpx" bgColor="#909399">标签3</xt-tag>
<xt-tag size="40rpx" bgColor="#E6A23C">标签4</xt-tag>
<xt-tag size="50rpx" bgColor="#F56C6C">标签5</xt-tag>
</view>
</view>
</view>
</template>
<script>
export default {
data() {
return {};
},
mounted() {},
methods: {
log(e) {
console.log(e);
},
close(e) {
console.log(e);
}
}
};
</script>
<style scoped>
.xt {
padding: 20rpx 10rpx;
display: flex;
flex-direction: column;
gap: 20rpx;
}
</style>
API
属性 |
类型 |
描述 |
默认值 |
show |
Boolean |
标签是否显示 |
true |
round |
Boolean |
是否圆形标签 |
false |
color |
String |
标签文本颜色 |
#F8FCFF |
size |
String |Number |
标签大小 |
30rpx |
name |
String |
标签唯一标识 |
无 |
bgColor |
String |
标签背景颜色 |
#409EFF |
borderColor |
String |
标签边框颜色 |
无 |
plain |
Boolean |
是否镂空 |
false |
plainFill |
Boolean |
镂空时是否填充背景 |
false |
iconColor |
String |
删除图标颜色 |
#F8FCFF |
radius |
String |Number |
标签圆角 |
5px |
closable |
Boolean |
标签是否可关闭 |
false |
stop |
Boolean |
是否阻止事件冒泡 |
false |
Events
方法名 |
类型 |
说明 |
click |
Function |
点击时触发,返回name |
close |
Function |
关闭标签时触发,返回name |