Skip to content

Bevy plugin for a simple single-line text input widget.

License

Notifications You must be signed in to change notification settings

rparrett/bevy_simple_text_input

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

91 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

bevy_simple_text_input

crates.io docs Following released Bevy versions

An unambitious single-line text input widget for bevy_ui.

animated screenshot of text input widget gaining focus and text typed and submitted

Usage

Important

Code and examples in the main branch are under development and may not be compatible with the released version on crates.io. The latest branch will contain the code from the most recent release.

See examples/basic.rs.

Features

I am not trying to build and maintain an enterprise-grade text input, just something that is good enough to be useful in small projects.

  • Scrolling
  • Keyboard cursor movement (char, word, start/end)
  • Disable / focus
  • Placeholders
  • Doesn't completely choke on unicode
  • Password masking
  • "Submit" events

Maybe

  • Input filtering
  • Length limit
  • Mouse cursor movement
  • Proper unicode grapheme support
  • IME support

Probably not

I might consider very high quality contributions in these areas, but probably won't be working on them myself. These would likely involve adding dependencies or adding lots of code that I don't want to commit to maintaining.

  • Multi-line
  • Copy / paste
  • Selection
  • Mobile

Definitely not

  • Rich text

Compatibility

bevy_simple_text_input bevy
0.10 0.15
0.8-0.9 0.14
0.4-0.7 0.13
0.3 0.12
0.1-0.2 0.11

Contributing

Please feel free to open a PR!

The code should be simple enough for users to quickly understand and modify for their own purposes. Any new dependencies must not also depend on Bevy. Ideally, we should not add any new dependencies.

Please keep PRs small and scoped to a single feature or fix.

Alternatives

If you need more features, check out bevy_cosmic_edit or bevy_egui.