跳到主要内容

Badge 徽标 ​

WebH5

徽标。在图标/头像等元素右上角展示计数或小红点,也可独立使用。

何时使用 ​

未读消息数、新内容提醒、状态小红点等轻量计数/提醒场景。

何时不使用 ​

展示分类或状态文本用 Tag;需要可点击操作用 Button。

Props ​

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

Slots ​

名称说明
default被包裹的内容,徽标定位到其右上角;缺省时徽标独立渲染
content自定义徽标内容(优先级高于 value/dot)

示例 ​

消息计数 ​

示例加载中…

小红点 ​

示例加载中…

独立使用 ​

示例加载中…

Playground ​

加载中…

跨端版本 ​

该组件同时提供 uni-app / uni-app X 实现(H5 / 微信小程序 / App),API 可能略有差异,见 uni-app 端 Badge 文档(含手机预览)。