Badge 徽标
WebH5
徽标。在图标/头像等元素右上角展示计数或小红点,也可独立使用。
何时使用
未读消息数、新内容提醒、状态小红点等轻量计数/提醒场景。
何时不使用
展示分类或状态文本用 Tag;需要可点击操作用 Button。
Props
| 名称 | 类型 | 默认值 | 说明 |
|---|---|---|---|
value | string | number | "undefined" | 徽标内容,通常为计数数字 |
max | number | "undefined" | 最大值;value 为数字且超过 max 时显示 ${max}+ |
dot | boolean | false | 小红点模式,忽略 value 仅显示圆点 |
showZero | boolean | false | value 为 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 文档(含手机预览)。