XU XUv0.13.1
EN

UI / WIDGETS / 反馈与浮层

ToastHost

统一呈现短暂通知

在演练场运行 Xu 示例

示例由浏览器中的 Xu/WASM 运行器执行。

体验什么

显示通知,再手动关闭。

使用要点

短暂通知由统一宿主管理。重要错误不应只显示为自动消失的通知,撤销或关闭操作需要可访问。

创建通知队列

ToastHost 是通知队列对象,由应用保存并驱动显示。

#ui/widgets

fn notifications() widgets.ToastHost {
    $host := widgets.toast_host()
    value := widgets.notice(&"Workspace saved")
    host.enqueue(&value) or >>
    << host
}

toast_host

XuAPI
pub fn toast_host() ToastHost

用途

执行 toast host 操作。

参数

无需传入参数。

返回值

ToastHost — 该类型的值

放置、状态与事件

组件由应用拥有。Screen.place 放置节点,Screen.set_enabled 和 Screen.set_visible 管理可用性与显示。状态变化后重新呈现;创建和修改时处理 or 错误,不在绘制回调中修改拓扑。ToastHost 使用自己的队列接口。

Action · Styles · 界面生命周期与样式指南

独立控件对象 API

struct ToastHost

XuAPI
pub struct ToastHost {

}

用途

ToastHost 上下文或状态结构体。

公开字段

此类型没有公开字段。

(&ToastHost) pending_count

XuAPI
pub fn (host &ToastHost) pending_count() int

用途

&ToastHost 上的操作:执行 pending count 操作。

参数

host &ToastHost
本次调用使用的 ToastHost 实例;以只读借用传入,调用方仍持有实例。

返回值

int — 该类型的值

($&ToastHost) set_capacity

XuAPI
pub fn (host $&ToastHost) set_capacity(capacity int) int

用途

$&ToastHost 上的操作:设置 capacity。失败时抛出错误,调用方需处理或继续传播。

参数

host $&ToastHost
本次调用使用的 ToastHost 实例;以独占借用传入,方法可修改它,调用方仍持有实例。
capacity int
capacity(int)

返回值

int — 该类型的值

($&ToastHost) enqueue

XuAPI
pub fn (host $&ToastHost) enqueue(value &Notice) int

用途

在 $&ToastHost 上执行 enqueue 操作。失败时抛出错误,调用方需处理或继续传播。

参数

host $&ToastHost
本次调用使用的 ToastHost 实例;以独占借用传入,方法可修改它,调用方仍持有实例。
value &Notice
value(只读借用,调用方仍持有原值;类型 &Notice)

返回值

int — 该类型的值

($&ToastHost) next_notice

XuAPI
pub fn (host $&ToastHost) next_notice() NoticeRecord

用途

$&ToastHost 上的操作:执行 next notice 操作。失败时抛出错误,调用方需处理或继续传播。

参数

host $&ToastHost
本次调用使用的 ToastHost 实例;以独占借用传入,方法可修改它,调用方仍持有实例。

返回值

NoticeRecord — 该类型的值

完整原生示例

Component Workshop · 返回 Widgets 目录