Skip to page content

徽章

QBadge(徽标)组件用于创建一个小徽标来添加一些引人注目的信息,例如经常有人把他放在头像组件上来显示有几条新消息。

用法

基础



对齐



圆角



描边



无障碍访问
v2.25+

QBadge 渲染时带有 role="status"——一个礼貌的 live region——并从 label 属性获取其 aria-label,所以当徽章的 label 在渲染后发生变化时会被自动播报(通过默认插槽传入的内容则作为纯文本被读取)。

floating(浮动)徽章仅在视觉上附着于宿主元素;二者之间没有程序化的关联。请确保宿主元素自身的无障碍名称能传达徽章的含义——例如"收件箱,4 封未读",而非仅仅在未标注的图标旁浮动一个"4"。