//! Demonstrates how to use the z-index component on UI nodes to control their relative depth //! //! It uses colored boxes with different z-index values to demonstrate how it can affect the order of //! depth of nodes compared to their siblings, but also compared to the entire UI. use bevy::{ color::palettes::basic::{BLUE, GRAY, LIME, PURPLE, RED, YELLOW}, prelude::*, }; fn main() { App::new() .insert_resource(ClearColor(Color::BLACK)) .add_plugins(DefaultPlugins) .add_systems(Startup, setup) .run(); } fn setup(mut commands: Commands) { commands.spawn(Camera2d); // spawn the container with default z-index. // the default z-index value is `ZIndex(0)`. // because this is a root UI node, using local or global values will do the same thing. commands .spawn(Node { width: percent(100), height: percent(100), align_items: AlignItems::Center, justify_content: JustifyContent::Center, ..default() }) .with_children(|parent| { parent .spawn(( Node { width: px(180), height: px(100), ..default() }, BackgroundColor(GRAY.into()), )) .with_children(|parent| { // spawn a node with default z-index. parent.spawn(( Node { position_type: PositionType::Absolute, left: px(10), bottom: px(40), width: px(100), height: px(50), ..default() }, BackgroundColor(RED.into()), )); // spawn a node with a positive local z-index of 2. // it will show above other nodes in the gray container. parent.spawn(( Node { position_type: PositionType::Absolute, left: px(45), bottom: px(30), width: px(100), height: px(50), ..default() }, ZIndex(2), BackgroundColor(BLUE.into()), )); // spawn a node with a negative local z-index. // it will show under other nodes in the gray container. parent.spawn(( Node { position_type: PositionType::Absolute, left: px(70), bottom: px(20), width: px(100), height: px(75), ..default() }, ZIndex(-1), BackgroundColor(LIME.into()), )); // spawn a node with a positive global z-index of 1. // it will show above all other nodes, because it's the highest global z-index in this example. // by default, boxes all share the global z-index of 0 that the gray container is added to. parent.spawn(( Node { position_type: PositionType::Absolute, left: px(15), bottom: px(10), width: px(100), height: px(60), ..default() }, BackgroundColor(PURPLE.into()), GlobalZIndex(1), )); // spawn a node with a negative global z-index of -1. // this will show under all other nodes including its parent, because it's the lowest global z-index // in this example. parent.spawn(( Node { position_type: PositionType::Absolute, left: px(-15), bottom: px(-15), width: px(100), height: px(125), ..default() }, BackgroundColor(YELLOW.into()), GlobalZIndex(-1), )); }); }); }