TouchArea

TouchArea

An invisible hit-testing region that detects clicks, hovers, and drags. Lives in aurora_widgets::interactables::touch_area. Wraps a child widget and adds interaction callbacks without changing its appearance.

Use TouchArea when you need click/hover behavior on a custom widget that isn't a Button.

Quick Start

use aurora_ui::prelude::*;

TouchArea::new()
    .child(Text::new("Click me"))
    .hover_cursor(CursorIcon::Pointer)
    .on_click(|event| println!("Clicked at {:?}", event.position))
    .on_hover(|_rect, hovering| println!("Hover: {hovering}"))

Builder Methods

Method	Type	Description
child(impl Widget)	Box<dyn Widget>	The widget to wrap
width(f32)	f32	Fixed width (overrides child's natural size)
height(f32)	f32	Fixed height
hover_cursor(CursorIcon)	CursorIcon	Cursor icon when hovering
on_click(FnMut(&MouseClickEvent))	callback	Fires on mouse release inside bounds
on_hover(FnMut(Rect, bool))	callback	(bounds, is_hovered) — fires on enter/leave
on_mouse_down(FnMut(MouseButton))	callback	Fires immediately on mouse press
on_drag(FnMut(Point))	callback	Fires on mouse move while pressed

Example

use aurora_ui::prelude::*;

// Custom interactive card
TouchArea::new()
    .child(
        BoxWidget::new()
            .width(200)
            .height(100)
            .background_color(Color::from_hex(0x334155, false))
            .corners(Corners::all(8.0))
            .child(Text::new("Drag me"))
    )
    .hover_cursor(CursorIcon::Grab)
    .on_drag(|pos| println!("Dragging at {pos:?}"))
    .on_click(|_| println!("Released"))