由 GPUI 的 Web 后端渲染的真实组件。需要支持 WebGPU 的浏览器。
ToastState::new(window, cx) 持有一个五秒的通知生命周期;如有需要,请在挂载之前设置
非零的 .with_duration(...)。即使在关闭状态下,也请在视图中保留匹配的
Toast::new(id, &state)。设置其无障碍消息、
主体和普通的操作 Button;ToastClose 提供关闭操作。
单个通知位使用一个 ToastState,堆叠则使用 ToasterState。
show 开始或替换消息,且不会获取焦点。已挂载的倒计时
会在悬停、包含焦点以及窗口处于非活动状态时暂停,然后从
剩余时长继续。dismiss、Escape 和关闭按钮属于显式关闭;
超时则由 ToastEvent 单独报告。如果显式关闭移除了
获得焦点的通知,会恢复其所捕获的先前焦点。未获得焦点时的
关闭会保留用户正在使用的任何控件。移除整个宿主
会将其关闭,且不会恢复所捕获的焦点;在移除获得焦点的内容时,应用必须将焦点移到
仍然存在的控件。原生的实时区域元数据
默认为 polite,对 .urgent(true) 则为 assertive;屏幕阅读器的实际朗读
仍须在每个平台上检查。
Toaster
ToasterState<T> 保留一个通知堆叠,其值 T 属于
应用,每个通知都由其自己的 ToastState 支撑:
let toasts = cx.new(|_| ToasterState::<SharedString>::new());
// Anywhere with a window:
let key = toasts.update(cx, |toasts, cx| toasts.push("Uploading…".into(), window, cx));
// Later, update the same notification in place and restart its lifetime.
toasts.update(cx, |toasts, cx| toasts.replace(key, "Upload complete".into(), window, cx));
Toaster::new("notifications", &toasts, |key, message, state| {
Toast::new(key, state)
.accessibility_label(message.clone())
.child(message.clone())
.child(ToastClose::new((ElementId::from(key), "close"), state))
})
.absolute()
.bottom_4()
.right_4()
.gap_2()push 显示一条通知且不获取焦点,并返回其 ToastKey,
它同样可转换为 ElementId。只有最新的 visible_limit 个条目
(默认三个)会被挂载,最新的在前;较早的条目会等待而不消耗
时间,并在较新的条目关闭时显示出来。with_duration 为之后的推送设置生命周期。
每个已挂载的 toast 都保留上述暂停、Escape 和焦点恢复
约定,并在因任何原因关闭时从堆叠中移除。
replace 更新仍处于打开状态的条目并重新开始其生命周期,当其
已经关闭时返回 false。dismiss(key) 和 dismiss_all 关闭条目;
len、is_empty 和 visible 暴露该堆叠。
focus_latest 将焦点移入最新的通知。请将其绑定到
应用的快捷键(例如 Alt+T),而不要在显示时调用它。
Toaster 渲染一个带名称的 Group(默认为 Notifications),并将位置、
间距和外观留给应用。