在以下示例中，用户可以通过更改 TextField 的内容来修改窗口的标题。

struct Application;

impl AppDelegate<AppState> for Application {
    fn configure_main_window(&mut self, state: &mut AppState) -> WindowConfiguration {
        state.title.set("My Application");

        WindowConfiguration::new()
            .with_title(state.title.clone())
    }

    fn make_content_view(&mut self, state: &mut AppState, _: Window) -> impl finestra::View<Self, AppState>  {
        Stack::horizontal()
            .with(Label::new("Choose a title:"))
            .with(TextField::new(state.title.clone()))
    }
}

#[derive(Debug, Default)]
struct AppState {
    title: TextValue,
}

fn main() {
    App::with_state(Application, AppState::default())
        .run();
}

点击此处查看完整示例。

堆叠

要将多个项目放置在同一行或列中，请使用 Stack 视图。这可以是水平（行状）或垂直（列状）。

fn make_content_view(&mut self, _: &mut (), _: Window) -> impl finestra::View<Self, ()> {
    Stack::horizontal()
        .with(Label::new("Hello, world!"))
        .with(Button::new("Click Me"))
        .with(Button::new("Goodbye, world!"))
}

要了解如何将这些功能结合起来创建强大的界面，请查看 计算器应用程序 示例。

对话框

当发生需要用户注意的特定事件时，您可以使用 对话框。

use rand::seq::SliceRandom;

const FRUITS: &[&str] = &[
    "Apple", "Banana",
    "Strawberry", "Orange",
    "Kiwi", "Pear",
    "Berries", "Lemon",
    // "Tomato",
];

Button::new("Random Fruit")
    .with_on_click(|_, window| {
        window.create_dialog(FRUITS.choose(&mut rand::thread_rng()))
                .title("Fruit")
                .kind(DialogKind::Informational)
                .show();
    })

有关更多信息，请参阅 DialogBuilder 和 DialogKind 的文档。

颜色

要使用与 Finestra 支持的每个平台都一致的色彩，可以使用 SystemColor 枚举

Label::new("BlueExampleSoftware")
    .with_color(Color::system(SystemColor::Blue))

这将确保您始终使用正确的颜色，并与系统应用程序保持一致。

如果您需要使用特定颜色，可以使用 Color::rgb() 和 Color::rgba() 函数

Label::new("Maroon Balloon 🎈")
    .with_color(Color::rgb(155, 68, 68))

您可以使用 State<Color> 模式自然地动态更改颜色。请参阅 Disco Button 示例以了解其实现方式。

组件概述

以下组件目前由 Finestra 支持

• Button 可以用来触发特定操作。
• ImageView 可以显示图片。
• Label 包含单行文本。
• Stack 可以水平或垂直放置项目。
• TextBlock 可以包含多行文本，并允许进行特定对齐。
• TextField 可以用来请求用户输入特定字符串。

理由

操作系统通常指定它们自己的设计语言，例如 Apple 的 人机界面指南 和 Microsoft 的 Windows 11 设计原则。这些指南提供以使用户能够体验到一致且熟悉的用户界面，并且遵守这些指南通常会被您的应用程序用户所欣赏，就像 Arc for Windows 在 X/Twitter 上受到赞扬。

^{_TODO: 更新博客文章_}

进一步阅读

• 文档
• 示例
• 路线图
• 许可证

版权

_{版权 (C) 2024 Tristan Gerritsen}

_{根据 Apache 许可证 2.0 版（“许可证”）；除非遵守许可证，否则不得使用此文件。您可以在 https://apache.ac.cn/licenses/LICENSE-2.0 获取许可证副本。}

_{除非适用法律要求或书面同意，否则根据许可证分发的软件按“现状”基础分发，不提供任何类型的保证或条件，无论是明示的还是默示的。有关许可证的具体语言，请参阅许可证。}

_{除非您明确声明，否则根据Apache-2.0许可证定义，您有意提交给Serde的任何贡献，将按上述方式双授权，不附加任何其他条款或条件。}