bevy_ui_text_input 0.6.0

Bevy UI text input plugin
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64

## Bevy UI Text Input


Text input crate for Bevy UI using cosmic text.

![Text Input Example](input_screen.png)

#### Basic usage


Spawn a `TextInputNode` component to create a text input:

```
commands
        .spawn((
            TextInputNode::default(),
            Node {
                width: Val::Px(500.),
                height: Val::Px(250.),
                ..default()
            },
        ))
```

The size has to be set using `Node`, there isn't any support for responsive sizing yet.
The active text input is set using the `InputFocus` resource. Inputs can also be set to activate on clicks.

There are a couple of examples, `text_input` is the most complete:
```
cargo run --example text_input
```

#### Features

* Undo and redo
* Text selection with keyboard and mouse
* Overwrite and insert edit modes
* Horizontally scrolling single line input
* Validated integer, decimal and hexadecimal input modes
* Vertical and horizontal scrolling
* Cut, copy, and paste with clipboard support
* Display prompt when empty
* Keyboard navigation supports page up & down, home & End, next & previous word, buffer start & end and scroll up & down
* Mouse wheel scrolling
* Max characters limit
* Double-click and triple-click to select words and paragraphs respectively

#### Problems + Bugs

* Scrolling can be glitchy if the line height isn't an exact divisor of the input box.
* The plugin can't access any existing `FontAtlasSet`s from `bevy_text` and has to create its own atlases for any fonts it uses.

#### Not supported (at least yet)

* IME
* Responsive sizing
* Rich text
* Syntax highlighting
* World UI
* Text2d
* Onscreen keyboard
* Clipboard on android

#### Compatibility


| Bevy      | bevy_ui_text_input |
|-----------|--------------------|
| 0.17      | 0.6                |
| 0.16      | 0.5                |