跳到主要内容

Tag 标签 ​

uni-appH5微信小程序App

uni-app 跨端标签组件。小胶囊样式,支持主色、成功、警告、危险与默认样式。

何时使用 ​

用于状态标记、分类标签等轻量信息展示。

何时不使用 ​

需要可交互筛选时,应使用 Checkbox 或 Chip 组件。

本文档为 uni-app 端组件契约;Web 端同名组件 API 可能略有差异,请以对应包文档为准。下方手机预览实时运行 uni-app H5 演示。

9:41
Tag 标签 · uni-app H5 实时运行 新窗口打开

Props ​

名称类型默认值说明
variantstring:'primary' | 'success' | 'warning' | 'danger' | 'default'"default"标签色彩变体
sizestring:'sm' | 'md'"md"标签尺寸
roundbooleanfalse全圆角(胶囊形)
closablebooleanfalse可关闭,右侧显示 × 按钮,点击触发 close 事件

Events ​

名称载荷说明
closeMouseEvent点击关闭按钮时触发(已阻止冒泡,不会同时触发 click)
clickEvent点击标签时触发

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>