n-badge 徽标
数量提示元素:出现在图标 / 按钮 / 卡片右上角,提示有待处理的新内容(未读消息、待办数量、促销标记)。两种形态由默认插槽自动判定——插槽有内容时为包角标(绝对定位于内容右上角),无插槽内容时为独立徽标(胶囊数字 / 圆点本位渲染)。
value是徽标数字,超过max截断为max+(如 max=99、value=120 显示 99+);max ≤ 0表示不启用截断dot圆点模式忽略数值,适合"有新内容但不便计数"的场景(如在线状态);show直接控制显隐(出现/消失无动画,想"为 0 时隐藏"绑:show="value > 0")- 包角标的默认定位是骑角(徽标中心与内容右上角点重合);
offsetX / offsetY为像素微调(正右 / 正下为正);两个偏移仅在包角标形态生效- 徽标与 n-button / n-tag 同为"宽度随内容收缩"的行内元素:放进纵向布局会被交叉轴拉宽,包角标时请放在横向行容器里(拉宽会让角标跑到内容远端)
平台兼容性
| App | H5 | 微信小程序 | 支付宝小程序 | 百度小程序 | 头条小程序 | QQ小程序 |
|---|---|---|---|---|---|---|
| √ | √ | √ | × | × | × | × |
API
属性
| 参数 | 说明 | 类型 | 默认值 | 可选值 |
|---|---|---|---|---|
| value | 徽标数字(dot 开启时被忽略;超出 max 显示 "max+") | Number | 0 | - |
| max | 数值溢出上限:value 超过它显示 "max+";≤0 表示不启用截断 | Number | 99 | - |
| dot | 圆点模式:只显示小圆点不显示数字 | Boolean | false | - |
| show | 是否显示徽标(直接显隐,无动画) | Boolean | true | - |
| type | 徽标色调(功能色,惯例默认红色 = 有新提醒) | String | error | primary<br/>success<br/>warning<br/>error<br/>info |
| offset-x | 包角标时水平偏移,px,正值向右、负值向左(仅包角标形态生效) | Number | 0 | - |
| offset-y | 包角标时垂直偏移,px,正值向下、负值向上(仅包角标形态生效) | Number | 0 | - |
| text-style | 微调徽标数字的行内样式,如 "font-weight:600"(页面 class 打不进组件内部) | String | "" | 与 css 相同 |
| custom-class | 挂到根节点的额外 class(类需定义在组件样式表内) | String | "" | - |
| custom-style | 根节点行内样式,如 "margin-left:8px" 用于和相邻元素排间距 | String | "" | 与 css 相同 |
插槽
| 插槽名 | 说明 |
|---|---|
| default | 包角标的宿主内容(图标 / 按钮 / 卡片等);不提供插槽时组件渲染为独立徽标 |