Struct FocusManager 

pub struct FocusManager {
    pub strategy: FocusStrategy,
    /* private fields */
}

Manages focus behavior for interactive components.

Different component types require different focus management strategies:

• Dialogs trap focus within their boundary
• Popovers restore focus to the trigger on close
• Menus focus the first item on open

FocusManager encapsulates these strategies and provides methods for programmatic focus control.

Fields

strategy: FocusStrategy

The focus strategy to use.

Implementations

impl FocusManager

pub fn new(strategy: FocusStrategy) -> Self

Create a new FocusManager with the given strategy.

pub fn dialog() -> Self

Create a FocusManager for a dialog (trap + restore).

pub fn menu() -> Self

Create a FocusManager for a menu (focus first item).

pub fn popover() -> Self

Create a FocusManager for a popover (restore on close).

pub fn with_container(self, id: impl Into<String>) -> Self

Set the container element ID.

pub fn container_id(&self) -> Option<&str>

Get the container ID.

pub fn save_restore_target(&mut self, element_id: impl Into<String>)

Record the currently focused element for later restoration.

pub fn restore_target(&self) -> Option<&str>

Get the element ID to restore focus to.

pub fn trap(&self, container_id: &str) -> FocusInstruction

Begin trapping focus within the container.

Returns focus instructions that the framework adapter should execute.

pub fn release(&self) -> FocusInstruction

Release the focus trap.

pub fn restore(&self) -> FocusInstruction

Restore focus to the previously focused element.

pub fn focus_first(&self, container_id: &str) -> FocusInstruction

Focus the first focusable child of a container.

pub fn focus_last(&self, container_id: &str) -> FocusInstruction

Focus the last focusable child of a container.

pub fn focus_next(&self) -> FocusInstruction

Focus the next focusable element.

pub fn focus_prev(&self) -> FocusInstruction

Focus the previous focusable element.

pub fn is_trapping(&self) -> bool

Whether this manager uses focus trapping.

pub fn should_restore(&self) -> bool

Whether this manager restores focus on close.

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 PartialEq for FocusManager

fn eq(&self, other: &FocusManager) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Eq for FocusManager

impl StructuralPartialEq for FocusManager