From 38dd6496ea60cad98238e8bcd737469ba46be34c Mon Sep 17 00:00:00 2001
From: Tyler Earls <tyler.a.earls@gmail.com>
Date: Sat, 18 Jul 2026 13:51:09 -0500
Subject: [PATCH 1/3] migrate example to use bevy_ui_widgets::Button

---
 examples/ui/images/ui_texture_atlas_slice.rs | 77 ++++++++++++++------
 1 file changed, 56 insertions(+), 21 deletions(-)

diff --git a/examples/ui/images/ui_texture_atlas_slice.rs b/examples/ui/images/ui_texture_atlas_slice.rs
index 0254157ad12b9..099a05de46b53 100644
--- a/examples/ui/images/ui_texture_atlas_slice.rs
+++ b/examples/ui/images/ui_texture_atlas_slice.rs
@@ -3,8 +3,11 @@
 
 use bevy::{
     color::palettes::css::{GOLD, ORANGE},
+    picking::hover::Hovered,
+    platform::collections::HashSet,
     prelude::*,
-    ui::widget::NodeImageMode,
+    ui::{widget::NodeImageMode, Pressed},
+    ui_widgets::Button,
 };
 
 fn main() {
@@ -16,30 +19,61 @@ fn main() {
 }
 
 fn button_system(
-    mut interaction_query: Query<
-        (&Interaction, &Children, &mut ImageNode),
-        (Changed<Interaction>, With<Button>),
+    mut buttons: Query<
+        (
+            Entity,
+            Option<Ref<Pressed>>,
+            Ref<Hovered>,
+            &mut ImageNode,
+            &Children,
+        ),
+        With<Button>,
     >,
+    mut removed_pressed: RemovedComponents<Pressed>,
     mut text_query: Query<&mut Text>,
 ) {
-    for (interaction, children, mut image) in &mut interaction_query {
-        let mut text = text_query.get_mut(children[0]).unwrap();
-        match *interaction {
-            Interaction::Pressed => {
-                **text = "Press".to_string();
-                if let Some(atlas) = &mut image.texture_atlas {
-                    atlas.index = (atlas.index + 1) % 30;
-                }
-                image.color = GOLD.into();
-            }
-            Interaction::Hovered => {
-                **text = "Hover".to_string();
-                image.color = ORANGE.into();
-            }
-            Interaction::None => {
-                **text = "Button".to_string();
-                image.color = Color::WHITE;
+    // Buttons that had `Pressed` removed this frame; change detection does not report removals.
+    let just_unpressed: HashSet<Entity> = removed_pressed.read().collect();
+    for (entity, pressed, hovered, mut image, children) in &mut buttons {
+        let changed = hovered.is_changed()
+            || pressed.as_ref().is_some_and(Ref::is_changed)
+            || just_unpressed.contains(&entity);
+        if changed {
+            set_button_style(
+                pressed.is_some(),
+                hovered.get(),
+                &mut image,
+                children,
+                &mut text_query,
+            );
+        }
+    }
+}
+
+/// Shared styling logic: pressed takes precedence over hover.
+fn set_button_style(
+    pressed: bool,
+    hovered: bool,
+    image: &mut ImageNode,
+    children: &Children,
+    text_query: &mut Query<&mut Text>,
+) {
+    let mut text = text_query.get_mut(children[0]).unwrap();
+    match (pressed, hovered) {
+        (true, _) => {
+            **text = "Press".to_string();
+            if let Some(atlas) = &mut image.texture_atlas {
+                atlas.index = (atlas.index + 1) % 30;
             }
+            image.color = GOLD.into();
+        }
+        (false, true) => {
+            **text = "Hover".to_string();
+            image.color = ORANGE.into();
+        }
+        (false, false) => {
+            **text = "Button".to_string();
+            image.color = Color::WHITE;
         }
     }
 }
@@ -79,6 +113,7 @@ fn setup(
                 parent
                     .spawn((
                         Button,
+                        Hovered::default(),
                         ImageNode::from_atlas_image(
                             texture_handle.clone(),
                             TextureAtlas {

From 9f8f1fd2a044b28d615f50b704cda0bf6c547087 Mon Sep 17 00:00:00 2001
From: Tyler Earls <tyler.a.earls@gmail.com>
Date: Sat, 18 Jul 2026 17:37:31 -0500
Subject: [PATCH 2/3] update documenting comments

---
 examples/ui/images/ui_texture_atlas_slice.rs | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/examples/ui/images/ui_texture_atlas_slice.rs b/examples/ui/images/ui_texture_atlas_slice.rs
index 099a05de46b53..dced19a8e4e05 100644
--- a/examples/ui/images/ui_texture_atlas_slice.rs
+++ b/examples/ui/images/ui_texture_atlas_slice.rs
@@ -18,6 +18,12 @@ fn main() {
         .run();
 }
 
+/// Updates each button label whenever its `Pressed` or `Hovered` state changes.
+/// The image node, defined from a spritesheet, will also update upon pressing the button.ß
+///
+/// `Hovered` always exists on the button, so `Ref::is_changed` catches hover transitions and
+/// the insertion of `Pressed`. Removal of `Pressed` is not reported by change detection, so we
+/// also restyle any button that just had `Pressed` removed this frame.
 fn button_system(
     mut buttons: Query<
         (

From 36a3442d5da6236d214ef4dc5d19863f36bae652 Mon Sep 17 00:00:00 2001
From: Tyler Earls <tyler.a.earls@gmail.com>
Date: Sun, 19 Jul 2026 09:43:10 -0500
Subject: [PATCH 3/3] fix typo in comments

---
 examples/ui/images/ui_texture_atlas_slice.rs | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/examples/ui/images/ui_texture_atlas_slice.rs b/examples/ui/images/ui_texture_atlas_slice.rs
index dced19a8e4e05..e8c1741471df1 100644
--- a/examples/ui/images/ui_texture_atlas_slice.rs
+++ b/examples/ui/images/ui_texture_atlas_slice.rs
@@ -19,7 +19,7 @@ fn main() {
 }
 
 /// Updates each button label whenever its `Pressed` or `Hovered` state changes.
-/// The image node, defined from a spritesheet, will also update upon pressing the button.ß
+/// The image node, defined from a spritesheet, will also update upon pressing the button.
 ///
 /// `Hovered` always exists on the button, so `Ref::is_changed` catches hover transitions and
 /// the insertion of `Pressed`. Removal of `Pressed` is not reported by change detection, so we