跳到主要内容

Badge 徽标 ​

uni-appH5微信小程序App

uni-app 跨端徽标组件。可显示数字、小红点或封顶数字,常用于图标或头像右上角。

何时使用 ​

用于提示未读数量或需要用户注意的状态。

何时不使用 ​

徽标数字过大或需要精确计数时,应考虑列表详情页。

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

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

Props ​

名称类型默认值说明
contentstring | number-徽标内容;数字超过 max 时显示为 {max}+
dotbooleanfalse是否只显示小红点
maxnumber-数字上限,超过时显示 {max}+
valuestring | number"undefined"徽标内容,通常为计数数字
showZerobooleanfalsevalue 为 0 时是否仍显示徽标
offset[number, number]"undefined"徽标相对右上角的位置微调 [x, y],单位 px

Slots ​

名称说明
default被包裹的元素,如图标、头像

示例 ​

数字徽标 ​

vue
<view class="row">
  <Badge :content="8"><view class="badge-anchor" /></Badge>
  <Badge :content="16"><Icon name="bell" :size="24" /></Badge>
  <Badge content="NEW"><Icon name="mail" :size="24" /></Badge>
</view>

最大值 ​

vue
<view class="row">
  <Badge :content="123" :max="99"><view class="badge-anchor" /></Badge>
  <Badge :content="12" :max="10"><view class="badge-anchor" /></Badge>
</view>

小红点 ​

vue
<view class="row">
  <Badge dot><view class="badge-anchor" /></Badge>
  <Badge dot><Icon name="mail" :size="24" /></Badge>
</view>

value / showZero / 偏移 ​

vue
<view class="row">
  <Badge :value="66"><Icon name="bell" :size="24" /></Badge>
  <Badge :value="0" show-zero><Icon name="mail" :size="24" /></Badge>
  <Badge :value="5" :offset="[6, -4]"><view class="badge-anchor" /></Badge>
</view>