Tag 标签
uni-appH5微信小程序App
uni-app 跨端标签组件。小胶囊样式,支持主色、成功、警告、危险与默认样式。
何时使用
用于状态标记、分类标签等轻量信息展示。
何时不使用
需要可交互筛选时,应使用 Checkbox 或 Chip 组件。
本文档为 uni-app 端组件契约;Web 端同名组件 API 可能略有差异,请以对应包文档为准。下方手机预览实时运行 uni-app H5 演示。
Props
| 名称 | 类型 | 默认值 | 说明 |
|---|---|---|---|
variant | string:'primary' | 'success' | 'warning' | 'danger' | 'default' | "default" | 标签色彩变体 |
size | string:'sm' | 'md' | "md" | 标签尺寸 |
round | boolean | false | 全圆角(胶囊形) |
closable | boolean | false | 可关闭,右侧显示 × 按钮,点击触发 close 事件 |
Events
| 名称 | 载荷 | 说明 |
|---|---|---|
close | MouseEvent | 点击关闭按钮时触发(已阻止冒泡,不会同时触发 click) |
click | Event | 点击标签时触发 |
Slots
| 名称 | 说明 |
|---|---|
default | 标签文本 |
示例
语义变体
vue
<view class="row">
<Tag>默认</Tag>
<Tag variant="primary">主题</Tag>
<Tag variant="success">成功</Tag>
<Tag variant="warning">警告</Tag>
<Tag variant="danger">危险</Tag>
</view>尺寸
vue
<view class="row">
<Tag size="sm" variant="primary">SM</Tag>
<Tag size="md" variant="primary">MD</Tag>
<Tag size="lg" variant="primary">LG</Tag>
</view>业务场景
vue
<view class="row">
<Tag variant="success">包邮</Tag>
<Tag variant="danger">限时抢</Tag>
<Tag variant="warning">库存紧张</Tag>
<Tag>新品</Tag>
</view>圆角与可关闭
vue
<view class="row">
<Tag variant="primary" round>圆角</Tag>
<Tag variant="success" closable>可关闭</Tag>
</view>