Skip to page content

横幅

QBanner 组件用于创建一个横幅元素,可以展示醒目的信息和可选的操作按钮。

根据 Material Design 设计规范,横幅通常应该显示在应用程序的顶部。当然,您也可以根据实际需求将其放置在任何合适的位置,包括 QDialog 组件中。

无障碍访问
v2.25+

QBanner 渲染时带有 role="alert",这是一个强制性(assertive)live region:动态插入的横幅(例如请求失败后出现的错误提示)会被立即播报,而随页面一起渲染的横幅则不会被播报。对于持续展示的、信息性的横幅(不应打断用户),请通过传入属性来覆盖其 role——使用 role="status" 进行礼貌播报,或使用地标性 role(如带 aria-labelregion)用于纯静态内容。