Skip to content

n-badge 徽标 ​

数量提示元素:出现在图标 / 按钮 / 卡片右上角,提示有待处理的新内容(未读消息、待办数量、促销标记)。两种形态由默认插槽自动判定——插槽有内容时为包角标(绝对定位于内容右上角),无插槽内容时为独立徽标(胶囊数字 / 圆点本位渲染)。

  1. value 是徽标数字,超过 max 截断为 max+(如 max=99、value=120 显示 99+);max ≤ 0 表示不启用截断
  2. dot 圆点模式忽略数值,适合"有新内容但不便计数"的场景(如在线状态);show 直接控制显隐(出现/消失无动画,想"为 0 时隐藏"绑 :show="value > 0")
  3. 包角标的默认定位是骑角(徽标中心与内容右上角点重合);offsetX / offsetY 为像素微调(正右 / 正下为正);两个偏移仅在包角标形态生效
  4. 徽标与 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 包角标的宿主内容(图标 / 按钮 / 卡片等);不提供插槽时组件渲染为独立徽标

记录 · 思考 · 创作