Root 视图

Root 组件是 GPUI Component 在窗口中的根提供者。要启用 GPUI Component 的功能，必须把 Root 作为窗口中的 第一层子节点。

这一点很重要。如果不把 Root 放在窗口的第一层，许多行为都会出现异常或不符合预期。

fn main() {
    gpui_platform::application().run(move |cx| {
        // This must be called before using any GPUI Component features.
        gpui_component::init(cx);

        cx.spawn(async move |cx| {
            cx.open_window(WindowOptions::default(), |window, cx| {
                let view = cx.new(|_| Example);
                // This first level on the window, should be a Root.
                cx.new(|cx| Root::new(view, window, cx))
            })
            .expect("Failed to open window");
        })
        .detach();
    });
}

浮层

对话框、抽屉、通知等 UI 都需要一个统一的展示层，Root 提供了这些浮层的渲染入口：

• Root::render_dialog_layer - 渲染当前打开的对话框
• Root::render_sheet_layer - 渲染当前打开的抽屉
• Root::render_notification_layer - 渲染通知列表

可以在你的第一层视图中这样放置这些图层（Root > YourFirstView）：

struct MyApp;

impl Render for MyApp {
    fn render(&mut self, window: &mut Window, cx: &mut Context<Self>) -> impl IntoElement {
        div()
            .size_full()
            .child("My App Content")
            .children(Root::render_dialog_layer(cx))
            .children(Root::render_sheet_layer(cx))
            .children(Root::render_notification_layer(cx))
    }
}

TIP

这里使用的是 children 而不是 child，因为当没有打开的 dialog、sheet 或 notification 时，这些方法会返回 None，GPUI 就不会渲染任何内容。