更新记录

1.0.0(2025-03-21) 下载此版本

发布初版


平台兼容性

Vue2 Vue3
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

隐私、权限声明

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

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

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

许可协议

MIT协议

使用中有什么不明白的地方,就向插件作者提问吧~ 我要提问