bevy_ui_forms

Xenira [email protected] :toc: :toc-placement!: :toclevels: 2 :sectnums: :icons: font :source-highlighter: highlight.js

////

你好，crates.io用户o/

如果您能阅读到这一点，那么crater.io仍然不支持asciidoc，因此文档无法正确渲染。请查看GitHub页面上的readme：https://github.com/xenira/bevy_ui_forms

////

向bevy_ui添加表单。

这最初是bevy_simple_text_input的一个分支，为bevy_ui提供了一个稍微雄心勃勃的单行文本输入小部件。

注意：虽然原始文本输入小部件工作得很好，但表单逻辑仍在开发中，可能存在错误，并且可能会更改。这也适用于输入，因为行为已更改。

它现在除了文本输入小部件外，还包括一些表单逻辑。

还有一个用于从结构体创建表单的宏。

toc::[]

从原始功能扩展

• 字符掩码
• 占位文本
• 剪贴板支持
• 焦点（每次一个活动文本输入，点击自动聚焦）
• 表单逻辑
• 表单 'derive' 宏
• Tab 键在文本输入之间切换
• Enter 键提交表单

使用方法

重要：主分支中的代码和示例处于开发中，可能不与crates.io上发布的版本兼容。请确保切换到相应的标签。

参见examples/basic.rs。

表单宏

.宏示例

use bevy::prelude::*;
use bevy_ui_forms::prelude::*;

#[form_struct]
#[derive(Debug, Clone)]
pub struct LoginData {
    #[form_field(active)]
    #[text_box(placeholder = "Username")]
    pub username: String,
    #[text_box(placeholder = "Password", mask = '*')]
    pub password: String,
    #[form_field(optional)]
    #[text_box(placeholder = "Email")]
    pub email: Option<String>,
}

.使用方法

fn setup(mut commands: Commands) {
    commands.spawn((
        LoginDataForm,
        NodeBundle {
            style: Style {
                flex_direction: FlexDirection::Column,
                row_gap: Val::Px(8.0),
                align_self: AlignSelf::Stretch,
                align_items: AlignItems::Stretch,
                ..default()
            },
            ..default()
        },
    ));
}
fn on_form_submit(
    mut ev_login_form: EventReader<LoginDataFormEvent>,
) {
    for ev in ev_login_form.read() {
        match &ev.event {
            FormEvent::Submit(data) => {
              // do something with the data
            }
            _ => {}
        }
    }
}

兼容性

.与Bevy版本的兼容性 [options="header"] |==== | bevy_ui_forms | bevy | 0.1 - latest | 0.13 |====