3 releases (breaking)

0.4.0 Aug 22, 2023
0.3.0 Aug 21, 2023
0.2.0 Nov 22, 2022

#8 in #val


Used in bevy_ui_styled

MIT/Apache

22KB
527 lines

bevy_ui_styled

Utility function that let's you define a bevy_ui Style component with tailwindcss inspired syntax.

If you are already familiar with tailwind classes just use them and it will probably work. As long as you only use the layout related classes. Not all features are supported, for example, bevy currently only supports flexbox. If you don't know tailwind but know bevy I'd recommend using the search in the tailwind docs which will give you a class that will probably work. It's not actually tailwind, just based on the same principles so plenty of things might not behave as expected.

Reference: https://tailwindcss.com

The basic idea is that each Style property has a simple short-hand value that can be used to compose more complex styles. The parameter is simply a space separated string of those short-hand.

Example

This is the button example in bevy 0.8

use bevy::prelude::*;

fn system(mut commands: Commands, asset_server: AssetServer) {
    commands
        .spawn(ButtonBundle {
            style: Style {
                width: Val::Px(150.0),
                height: Val::Px(65.0),
                margin: UiRect::all(Val::Auto),
                justify_content: JustifyContent::Center,
                align_items: AlignItems::Center,
                ..default()
            },
            background_color: Color::RED.into(),
            ..default()
        })
        .with_children(|parent| {
            parent.spawn(TextBundle::from_section("Button", TextStyle::default()));
        });
}

The same example using bevy_ui_styled

use bevy::prelude::*;
use bevy_ui_styled::styled;

fn system(mut commands: Commands, asset_server: AssetServer) {
    commands
        .spawn(ButtonBundle {
            style: styled!("w-150 h-65 m-auto justify-center items-center"),
            background_color: Color::RED.into(),
            ..default()
        })
        .with_children(|parent| {
            parent.spawn(TextBundle::from_section("Button", TextStyle::default()));
        });
}

Px, Percent, Auto

Some of those utilities support passing a numerical value. Numbers are parsed as f32 so you can pass it any valid f32. If you use a fraction, it will compute the value as a percentage and clamp it to 100%.

use bevy_ui_styled::styled;

styled!("m-50"); // a 50px margin
styled!("m-1.5"); // a 1.5px margin
styled!("m-1/2"); // a 1/2 margin. Any fraction will be converted to a percentage and clamped to 100%
styled!("m-50%"); // a 50% margin
styled!("m-auto"); // a Val::Auto margin

Warning: In tailwind, decimal values are used to represent em values. Since bevy only supports percent and pixels I simply evaluate it as a pixel value. I don't know how bevy interprets a 0.5 pixel.

Colors

bevy_ui_styled has a colors module that contains the default colors from tailwind. Unlike tailwind these aren't easily customizable, but you can use const CUSTOM_COLOR: Color if you want custom colors. The goal of this module is to have some basic colors to get you started.

Styled Bundle

Background color

The background color is not a part of the Style struct so the default styled macro can't control it. If you want to be able to modify the background color you'll need to use the styled_bundle macro.

Stateful styles

Sometimes, you want to change a property based on the state of the component. The default styled macro doesn't do that, but you can use styled_bundle instead. styled_bundle will return a Bundle containing different styles that will automatically be toggled based on interaction state.

Bevy Version Support

bevy_ui_styled bevy
0.4 0.11
0.3 0.10
0.2 0.9

Dependencies

~20–30MB
~473K SLoC