 9f906fdc8b
			
		
	
	
		9f906fdc8b
		
	
	
	
	
		
			
			# Objective
Creating UI elements is very boilerplate-y with lots of indentation.
This PR aims to reduce boilerplate around creating text elements.
## Changelog
* Renamed `Text::with_section` to `from_section`.
  It no longer takes a `TextAlignment` as argument, as the vast majority of cases left it `Default::default()`.
* Added `Text::from_sections` which creates a `Text` from a list of `TextSections`.
  Reduces line-count and reduces indentation by one level.
* Added `Text::with_alignment`.
  A builder style method for setting the `TextAlignment` of a `Text`.
* Added `TextSection::new`.
  Does not reduce line count, but reduces character count and made it easier to read. No more `.to_string()` calls!
* Added `TextSection::from_style` which creates an empty `TextSection` with a style.
  No more empty strings! Reduces indentation.
* Added `TextAlignment::CENTER` and friends.
* Added methods to `TextBundle`. `from_section`, `from_sections`, `with_text_alignment` and `with_style`.
## Note for reviewers.
Because of the nature of these changes I recommend setting diff view to 'split'.
~~Look for the book icon~~ cog in the top-left of the Files changed tab.
Have fun reviewing ❤️
<sup> >:D </sup>
## Migration Guide
`Text::with_section` was renamed to `from_section` and no longer takes a `TextAlignment` as argument.
Use `with_alignment` to set the alignment instead.
Co-authored-by: devil-ira <justthecooldude@gmail.com>
		
	
			
		
			
				
	
	
		
			69 lines
		
	
	
		
			2.2 KiB
		
	
	
	
		
			Rust
		
	
	
	
	
	
			
		
		
	
	
			69 lines
		
	
	
		
			2.2 KiB
		
	
	
	
		
			Rust
		
	
	
	
	
	
| //! Demonstrates how to use transparency with UI.
 | |
| //! Shows two colored buttons with transparent text.
 | |
| 
 | |
| use bevy::prelude::*;
 | |
| 
 | |
| fn main() {
 | |
|     App::new()
 | |
|         .insert_resource(ClearColor(Color::BLACK))
 | |
|         .add_plugins(DefaultPlugins)
 | |
|         .add_startup_system(setup)
 | |
|         .run();
 | |
| }
 | |
| 
 | |
| fn setup(mut commands: Commands, asset_server: Res<AssetServer>) {
 | |
|     commands.spawn_bundle(Camera2dBundle::default());
 | |
| 
 | |
|     let font_handle = asset_server.load("fonts/FiraSans-Bold.ttf");
 | |
| 
 | |
|     commands
 | |
|         .spawn_bundle(ButtonBundle {
 | |
|             style: Style {
 | |
|                 size: Size::new(Val::Px(150.0), Val::Px(65.0)),
 | |
|                 margin: UiRect::all(Val::Auto),
 | |
|                 justify_content: JustifyContent::Center,
 | |
|                 align_items: AlignItems::Center,
 | |
|                 ..default()
 | |
|             },
 | |
|             color: Color::rgb(0.1, 0.5, 0.1).into(),
 | |
|             ..default()
 | |
|         })
 | |
|         .with_children(|parent| {
 | |
|             parent.spawn_bundle(TextBundle::from_section(
 | |
|                 "Button 1",
 | |
|                 TextStyle {
 | |
|                     font: font_handle.clone(),
 | |
|                     font_size: 40.0,
 | |
|                     // Alpha channel of the color controls transparency.
 | |
|                     color: Color::rgba(1.0, 1.0, 1.0, 0.2),
 | |
|                 },
 | |
|             ));
 | |
|         });
 | |
| 
 | |
|     // Button with a different color,
 | |
|     // to demonstrate the text looks different due to its transparency.
 | |
|     commands
 | |
|         .spawn_bundle(ButtonBundle {
 | |
|             style: Style {
 | |
|                 size: Size::new(Val::Px(150.0), Val::Px(65.0)),
 | |
|                 margin: UiRect::all(Val::Auto),
 | |
|                 justify_content: JustifyContent::Center,
 | |
|                 align_items: AlignItems::Center,
 | |
|                 ..default()
 | |
|             },
 | |
|             color: Color::rgb(0.5, 0.1, 0.5).into(),
 | |
|             ..default()
 | |
|         })
 | |
|         .with_children(|parent| {
 | |
|             parent.spawn_bundle(TextBundle::from_section(
 | |
|                 "Button 2",
 | |
|                 TextStyle {
 | |
|                     font: font_handle.clone(),
 | |
|                     font_size: 40.0,
 | |
|                     // Alpha channel of the color controls transparency.
 | |
|                     color: Color::rgba(1.0, 1.0, 1.0, 0.2),
 | |
|                 },
 | |
|             ));
 | |
|         });
 | |
| }
 |