bevy_text_edit

快速入门

插件

将插件 TextEditPlugin 添加到应用中并定义它将运行的哪些状态

#[derive(Clone, Debug, Default, Eq, PartialEq, Hash, States)]
enum GameState {
    #[default]
    Menu,
}

fn main() {
    App::new()
        .add_plugins(DefaultPlugins)
        // Add the plugin
        .add_plugins(TextEditPlugin::new(vec![GameState::Menu]))
        .run;
}

如果您不关心游戏状态且希望始终运行输入文本，请使用 TextEditPluginNoState

fn main() {
    App::new()
        .add_plugins(DefaultPlugins)
        // Add the plugin
        .add_plugins(TextEditPluginNoState)
        .add_systems(Startup, setup)
        .run();
}

组件

将组件 TextEditable 和 Interaction 插入任何需要可编辑的文本实体中

commands.spawn((
    TextEditable::default(), // Mark text is editable
    Interaction::None,       // Mark entity is interactable
    TextBundle::from_section(
        "Input Text 1",
        TextStyle::default(),
    ),
));

只有通过点击获得焦点的文本才能接收键盘输入。

还可以通过 filter_in 和 filter_out 属性限制允许输入的字符。支持正则表达式

commands.spawn((
    TextEditable {
        filter_in: vec!["[0-9]".into(), " ".into()], // Only allow number and space
        filter_out: vec!["5".into()],                // Ignore number 5
    },
    Interaction::None,
    TextBundle::from_section(
        "Input Text 1",
        TextStyle::default(),
    ),
));

许可证

请参阅 LICENSE.

兼容 Bevy 版本