低代码高性能原生UI框架

Appearance

本页导读

Tag ​

组件类型：UxTagComponentPublicInstance

支持多种主题标签、镂空标签，可配置关闭按钮

平台兼容性 ​

UniApp X ​

AndroidiOSweb鸿蒙 Next小程序
√√√√√

UniApp Vue Nvue ​

AndroidiOSweb鸿蒙 Next小程序
xx√xx

Props ​

属性名类型默认值说明
themeString主题
textString标签文字
colorString标签文字颜色
darkColorString深色none-不显示，auto-自动适配深色模式，其他-颜色
sizeAny$ux.Conf.fontSize标签文字大小
boldBooleanfalse标签文字加粗
backgroundString标签背景颜色
backgroundDarkString深色none-不显示，auto-自动适配深色模式，其他-颜色
cornerAny5圆角
plainBooleanfalse是否镂空
closableBooleanfalse显示可关闭图标父级需加入’overflow:visible‘才可正常显示
iconString标签图标
iconSizeString$ux.Conf.fontSize图标大小
customFamilyString自定义字体family
directionStringrow布局方向
marginArray边距[上右下左][上下左右][上下左右]
mtAny距上单位px
mrAny距右单位px
mbAny距下单位px
mlAny距左单位px
paddingArray填充[上右下左][上下左右][上下左右]
ptAny上内边距单位px
prAny右内边距单位px
pbAny下内边距单位px
plAny左内边距单位px
xstyleArray自定义样式
disabledBooleanfalse是否禁用

theme ​

值说明
text文字
info默认
primary主要
success成功
warning警告
error错误

darkColor ​

值说明
none不显示
auto自动适配深色模式
color其他颜色

backgroundDark ​

值说明
none不显示
auto自动适配深色模式
color其他颜色

direction ​

值说明
row水平
column垂直

Events ​

事件名说明参数
click点击触发
close点击关闭触发

示例代码 ​

html
<template>
	<ux-page :stack="showDoc">
		<ux-navbar :title="title" :bold="true">
			<template v-slot:right>
				<!-- #ifndef MP -->
				<ux-button theme="text" icon="/static/tip.png" :icon-size="22" @click="onDoc()"></ux-button>
				<!-- #endif -->
			</template>
		</ux-navbar>
		
		<ux-scroll>
			<ux-card direction="column" icon="flag-filled" title="标签" :bold="true">
				<ux-text text="支持多种主题标签、镂空标签，可配置关闭按钮"></ux-text>
			</ux-card>
			
			<ux-card direction="column" icon="arrowright" title="主题" :bold="true">
				<ux-text text="多种主题可配置，适配暗黑模式" :mb="15"></ux-text>
				<ux-row>
					<ux-tag theme="info" text="默认" :mr="10"></ux-tag>
					<ux-tag theme="primary" text="主要" :mr="10"></ux-tag>
					<ux-tag theme="success" text="成功" :mr="10"></ux-tag>
					<ux-tag theme="warning" text="警告" :mr="10"></ux-tag>
					<ux-tag theme="error" text="错误" :mr="10"></ux-tag>
				</ux-row>
			</ux-card>
			
			<ux-card direction="column" icon="arrowright" title="镂空标签" :bold="true">
				<ux-text text="支持镂空标签，适配暗黑模式" :mb="15"></ux-text>
				<ux-row>
					<ux-tag :plain="true" theme="info" text="默认" :mr="10"></ux-tag>
					<ux-tag :plain="true" theme="primary" text="主要" :mr="10"></ux-tag>
					<ux-tag :plain="true" theme="success" text="成功" :mr="10"></ux-tag>
					<ux-tag :plain="true" theme="warning" text="警告" :mr="10"></ux-tag>
					<ux-tag :plain="true" theme="error" text="错误"></ux-tag>
				</ux-row>
			</ux-card>
			
			<ux-card direction="column" icon="arrowright" title="自定义样式" :bold="true">
				<ux-text text="支持配置图标、加载状态、圆角、背景色" :mb="15"></ux-text>
				<ux-row>
					<ux-tag :corner="20" theme="error" text="圆角" :mr="10"></ux-tag>
					<ux-tag theme="success" icon="plus" text="带图标" color="white" :mr="10"></ux-tag>
					<ux-tag theme="warning" background="#F5319D" text="背景色" :mr="10"></ux-tag>
				</ux-row>
			</ux-card>
			
			<ux-card direction="column" icon="arrowright" title="禁用标签" :bold="true">
				<ux-text text="支持禁用标签，适配暗黑模式" :mb="15"></ux-text>
				<ux-row>
					<ux-tag :disabled="true" theme="info" text="默认" :mr="10"></ux-tag>
					<ux-tag :disabled="true" theme="primary" text="主要" :mr="10"></ux-tag>
					<ux-tag :disabled="true" theme="success" text="成功" :mr="10"></ux-tag>
					<ux-tag :disabled="true" theme="warning" text="警告" :mr="10"></ux-tag>
					<ux-tag :disabled="true" theme="error" text="错误" :mr="10"></ux-tag>
				</ux-row>
			</ux-card>
			
			<ux-card direction="column" icon="arrowright" title="可删除" :bold="true">
				<ux-text text="支持配置显示删除按钮" :mb="15"></ux-text>
				<ux-row style="overflow: visible">
					<ux-tag :closable="true" :plain="true" theme="info" text="默认" :mr="10"></ux-tag>
					<ux-tag :closable="true" :plain="true" theme="primary" text="主要" :mr="10"></ux-tag>
					<ux-tag :closable="true" theme="success" text="成功" :mr="10"></ux-tag>
					<ux-tag :closable="true" theme="warning" text="警告" :mr="10"></ux-tag>
					<ux-tag :closable="true" theme="error" text="错误" :mr="10"></ux-tag>
				</ux-row>
			</ux-card>
			
			<ux-placeholder :height="200">
				<ux-row justify="center" align="center" style="height: 100%;">
					<ux-text prefix-icon="soapbubble-filled" text="真的没有了~"></ux-text>
				</ux-row>
			</ux-placeholder>
		</ux-scroll>
	</ux-page>
</template>
<template>
	<ux-page :stack="showDoc">
		<ux-navbar :title="title" :bold="true">
			<template v-slot:right>
				<!-- #ifndef MP -->
				<ux-button theme="text" icon="/static/tip.png" :icon-size="22" @click="onDoc()"></ux-button>
				<!-- #endif -->
			</template>
		</ux-navbar>
		
		<ux-scroll>
			<ux-card direction="column" icon="flag-filled" title="标签" :bold="true">
				<ux-text text="支持多种主题标签、镂空标签，可配置关闭按钮"></ux-text>
			</ux-card>
			
			<ux-card direction="column" icon="arrowright" title="主题" :bold="true">
				<ux-text text="多种主题可配置，适配暗黑模式" :mb="15"></ux-text>
				<ux-row>
					<ux-tag theme="info" text="默认" :mr="10"></ux-tag>
					<ux-tag theme="primary" text="主要" :mr="10"></ux-tag>
					<ux-tag theme="success" text="成功" :mr="10"></ux-tag>
					<ux-tag theme="warning" text="警告" :mr="10"></ux-tag>
					<ux-tag theme="error" text="错误" :mr="10"></ux-tag>
				</ux-row>
			</ux-card>
			
			<ux-card direction="column" icon="arrowright" title="镂空标签" :bold="true">
				<ux-text text="支持镂空标签，适配暗黑模式" :mb="15"></ux-text>
				<ux-row>
					<ux-tag :plain="true" theme="info" text="默认" :mr="10"></ux-tag>
					<ux-tag :plain="true" theme="primary" text="主要" :mr="10"></ux-tag>
					<ux-tag :plain="true" theme="success" text="成功" :mr="10"></ux-tag>
					<ux-tag :plain="true" theme="warning" text="警告" :mr="10"></ux-tag>
					<ux-tag :plain="true" theme="error" text="错误"></ux-tag>
				</ux-row>
			</ux-card>
			
			<ux-card direction="column" icon="arrowright" title="自定义样式" :bold="true">
				<ux-text text="支持配置图标、加载状态、圆角、背景色" :mb="15"></ux-text>
				<ux-row>
					<ux-tag :corner="20" theme="error" text="圆角" :mr="10"></ux-tag>
					<ux-tag theme="success" icon="plus" text="带图标" color="white" :mr="10"></ux-tag>
					<ux-tag theme="warning" background="#F5319D" text="背景色" :mr="10"></ux-tag>
				</ux-row>
			</ux-card>
			
			<ux-card direction="column" icon="arrowright" title="禁用标签" :bold="true">
				<ux-text text="支持禁用标签，适配暗黑模式" :mb="15"></ux-text>
				<ux-row>
					<ux-tag :disabled="true" theme="info" text="默认" :mr="10"></ux-tag>
					<ux-tag :disabled="true" theme="primary" text="主要" :mr="10"></ux-tag>
					<ux-tag :disabled="true" theme="success" text="成功" :mr="10"></ux-tag>
					<ux-tag :disabled="true" theme="warning" text="警告" :mr="10"></ux-tag>
					<ux-tag :disabled="true" theme="error" text="错误" :mr="10"></ux-tag>
				</ux-row>
			</ux-card>
			
			<ux-card direction="column" icon="arrowright" title="可删除" :bold="true">
				<ux-text text="支持配置显示删除按钮" :mb="15"></ux-text>
				<ux-row style="overflow: visible">
					<ux-tag :closable="true" :plain="true" theme="info" text="默认" :mr="10"></ux-tag>
					<ux-tag :closable="true" :plain="true" theme="primary" text="主要" :mr="10"></ux-tag>
					<ux-tag :closable="true" theme="success" text="成功" :mr="10"></ux-tag>
					<ux-tag :closable="true" theme="warning" text="警告" :mr="10"></ux-tag>
					<ux-tag :closable="true" theme="error" text="错误" :mr="10"></ux-tag>
				</ux-row>
			</ux-card>
			
			<ux-placeholder :height="200">
				<ux-row justify="center" align="center" style="height: 100%;">
					<ux-text prefix-icon="soapbubble-filled" text="真的没有了~"></ux-text>
				</ux-row>
			</ux-placeholder>
		</ux-scroll>
	</ux-page>
</template>
ts
<script setup>
	
	import * as plus from '@/uni_modules/ux-plus'
	
	const title = ref('')
	const showDoc = ref(false)
	
	function onDoc() {
		plus.openWeb({
			title: '在线文档',
			url: 'https://www.uxframe.cn/component/tag.html',
			// blur: 1,
			success: () => {
				showDoc.value = true
			},
			complete: () => {
				showDoc.value = false
			}
		})
	}
	
	onLoad((e: OnLoadOptions) => {
		title.value = e['title'] ?? ''
	})
</script>
<script setup>
	
	import * as plus from '@/uni_modules/ux-plus'
	
	const title = ref('')
	const showDoc = ref(false)
	
	function onDoc() {
		plus.openWeb({
			title: '在线文档',
			url: 'https://www.uxframe.cn/component/tag.html',
			// blur: 1,
			success: () => {
				showDoc.value = true
			},
			complete: () => {
				showDoc.value = false
			}
		})
	}
	
	onLoad((e: OnLoadOptions) => {
		title.value = e['title'] ?? ''
	})
</script>
css
<style lang="scss">
	
</style>
<style lang="scss">
	
</style>