Badges 徽标数

2019-05-21wangkailang

出现在按钮、图标、文字旁的数字或状态标记。

使用场景#

  • 与其他元素结合使用,用于显示该元素需要处理的消息条数、状态、新功能、数量等。
  • 不与其他元素相关联,独立展示状态时,请使用 tag 标签。
  • 展示某元素的补充信息或提示信息时,请使用 tooltip 文字提示。

使用原则#

  • 若用于提醒用户处理信息,使用包裹在元素上的红色徽标,信息处理完后,徽标消失。
  • 若用于展示状态,使用独立存在于元素左侧或右侧的徽标,用颜色表示状态,数字为零时也不消失。
  • 若只用于展示相关元素的数量信息,无吸引用户视觉的需求时,不使用醒目的样式。
  • 展示数字时需设置封顶数字,超过则显示(封顶数字+),默认值为99。
  • 不建议在一个元素上同时使用两种及以上的徽标。

代码演示#

资源/数据状态#

  1. 状态颜色围绕文本展示。默认为 danger:
  1. 状态颜色与文本分离展示:
  1. 当 count 为 0 时,默认不展示,可以设置为展示:

尺寸大小#

可以结合 dot 属性设置展示大小。默认为 small。

封顶数值#

数字展示可以设定最大的数,默认为 99。

消息展示#

API#

参数类型默认值说明
countunion(string, number)-数值 number|string
showZerobool-数值为0时,是否展示 Badge
dotbool-展示一个小点
sizestring'small'点的大小,只在dot为true的时候生效 ['small', 'middle', 'large']
statusstring'danger'设置状态颜色 ['default', 'primary', 'success', 'info', 'critical', 'warning', 'danger']
overflowCountnumber99封顶数值
textstring-状态点对应的文本
titlestring-鼠标hover在点上展现的文字, 默认为count