Struct FocusManager 

pub struct FocusManager { /* private fields */ }

Tracks and moves keyboard focus within a WidgetTree.

Implementations

impl FocusManager

pub fn new() -> Self

Create a manager with nothing focused and no active trap.

pub fn focused(&self) -> Option<WidgetId>

The currently focused node, if any.

pub fn trap(&self) -> Option<WidgetId>

The active focus-trap root, if any.

pub fn focusable_set(&self, tree: &WidgetTree) -> Vec<WidgetId>

The ordered list of focusable nodes that focus may currently move between, honouring any active trap (only the trap’s focusable descendants — and the trap node itself if focusable — are included).

pub fn focus(&mut self, tree: &WidgetTree, id: WidgetId) -> bool

Focus id if it is currently focusable (and inside the trap, if any). Returns true on success.

pub fn blur(&mut self)

Clear focus.

pub fn push_trap( &mut self, tree: &WidgetTree, trap: WidgetId, ) -> Option<WidgetId>

Activate a focus trap rooted at trap. If the current focus falls outside the trap, focus moves to the first focusable node within it. Returns the node focused after activation, if any.

pub fn pop_trap(&mut self)

Release the active focus trap. Focus is left where it is.

pub fn focus_next(&mut self, tree: &WidgetTree) -> Option<WidgetId>

Move focus to the next focusable node in tab order (wraps around). Returns the newly focused node, or None if nothing is focusable.

pub fn focus_prev(&mut self, tree: &WidgetTree) -> Option<WidgetId>

Move focus to the previous focusable node in tab order (wraps around).

pub fn autofocus( &mut self, tree: &WidgetTree, is_autofocus: impl Fn(WidgetId) -> bool, ) -> Option<WidgetId>

Focus the first node in tab order whose autofocus flag (as supplied by is_autofocus) is true. Returns the focused node, if one matched.

The tree node has no dedicated autofocus field, so the predicate lets callers decide (e.g. by inspecting a node’s label or an external map).

pub fn reconcile(&mut self, tree: &WidgetTree) -> bool

Drop focus if the focused node is no longer present or no longer focusable (call after removing/reparenting nodes). Returns true if focus was cleared as a result.

Trait Implementations

impl Clone for FocusManager

fn clone(&self) -> FocusManager

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for FocusManager

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for FocusManager

fn default() -> FocusManager

Returns the “default value” for a type.