https://github.com/rustunit/bevy_web_popups

Allows to trigger web/dom based popups/alerts and textinput in bevy
https://github.com/rustunit/bevy_web_popups

bevy gamedev web webdev

Last synced: 3 months ago
JSON representation

Allows to trigger web/dom based popups/alerts and textinput in bevy

• Host: GitHub
• URL: https://github.com/rustunit/bevy_web_popups
• Owner: rustunit
• License: apache-2.0
• Created: 2024-08-29T05:47:31.000Z (4 months ago)
• Default Branch: main
• Last Pushed: 2024-09-12T08:22:41.000Z (4 months ago)
• Last Synced: 2024-09-27T07:02:53.618Z (4 months ago)
• Topics: bevy, gamedev, web, webdev
• Language: Rust
• Homepage: https://crates.io/crates/bevy_web_popups
• Size: 1.94 MB
• Stars: 4
• Watchers: 1
• Forks: 4
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE-APACHE

Awesome Lists containing this project

README

        
# bevy_web_popups

[![crates.io][sh_crates]][lk_crates]

[![docs.rs][sh_docs]][lk_docs]

[![discord][sh_discord]][lk_discord]

[sh_crates]: https://img.shields.io/crates/v/bevy_web_popups.svg

[lk_crates]: https://crates.io/crates/bevy_web_popups

[sh_docs]: https://img.shields.io/docsrs/bevy_web_popups

[lk_docs]: https://docs.rs/bevy_web_popups/latest/bevy_web_popups/

[sh_discord]: https://img.shields.io/discord/1176858176897953872?label=discord&color=5561E6

[lk_discord]: https://discord.gg/rQNeEnMhus

Allows to trigger web/dom based popups/alerts and textinput in bevy using wasm-bindgen's [web_sys](https://docs.rs/web-sys/latest/web_sys/).

It is fully customizable but comes with a batteries included default style (see demo below).

See also:

[bevy_ios_iap](https://github.com/rustunit/bevy_ios_iap), [bevy_ios_gamecenter](https://github.com/rustunit/bevy_ios_gamecenter), [bevy_ios_notifications](https://github.com/rustunit/bevy_ios_notifications), [bevy_ios_alerts](https://github.com/rustunit/bevy_ios_alerts), [bevy_ios_review](https://github.com/rustunit/bevy_ios_review), [bevy_ios_impact](https://github.com/rustunit/bevy_ios_impact) & [bevy_device_lang](https://github.com/rustunit/bevy_device_lang)

See the crate in action in [TinyTakeoff](www.tinytakeoff.com):

![demo](./assets/demo.gif)

## Features

* `window.alert()`

* popup dialog with background darkening, textinput, cancel and ok button (fully customizable)

## Usage

Add dependency: `bevy_web_popups = "0.1"`

Initialize Bevy Plugin:

```rust

// request initialisation right on startup

app.add_plugins(WebAlertsPlugin);

```

```rust

fn bevy_system() {

    // trigger native browser alert message popup

    bevy_web_popups::alert("important msg");

    // trigger complex text input popup with a custom title, custom labels for the buttons and asking to spawn default css classes instead of specifying them ourselfs

    bevy_web_popups::show_textinput("set nickname:", "ok", "cancel", true);

}

// system processing events coming from the web plugin

fn process_events(

    mut events: EventReader,

) {

    for e in events.read() {

        if let WebAlertResponse::InputOk(text) = e {

            info!("user confirmed with text: {text}");

        }

    }

}

```

## Bevy version support

|bevy|bevy\_ios\_iap|

|---|---|

|0.13|0.2,main|

|0.13|0.1|

# License

All code in this repository is dual-licensed under either:

- MIT License (LICENSE-MIT or http://opensource.org/licenses/MIT)

- Apache License, Version 2.0 (LICENSE-APACHE or http://www.apache.org/licenses/LICENSE-2.0)

at your option. This means you can select the license you prefer.

## Your contributions

Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in the work by you, as defined in the Apache-2.0 license, shall be dual licensed as above, without any additional terms or conditions.