Struct FocusRequester 

pub struct FocusRequester { /* private fields */ }

Imperative handle used to request focus for a registered target.

Requesters are stable handles that can be stored in component state and passed across component boundaries without exposing the underlying focus tree.

Implementations

impl FocusRequester

pub fn new() -> Self

Creates a new focus requester.

pub fn request_focus(&self)

Requests focus for the bound target.

An attached target hidden by layout rejects the request. Navigation can still reveal a placed target outside its scroll viewport.

pub fn clear_focus(&self)

Clears focus from the bound target if it currently holds it.

pub fn unfocus(&self)

Alias for Self::clear_focus.

pub fn capture_focus(&self)

Captures focus on this node, preventing focus from moving elsewhere until released, force-cleared, hidden by layout, or removed.

pub fn free_focus(&self)

Releases captured focus from this node.

pub fn state(&self) -> FocusState

Returns the current focus state for the bound target.

pub fn has_focus(&self) -> bool

Returns true when this node is in the active focus path.

pub fn is_focused(&self) -> bool

Returns true when this node is the primary focused node.

pub fn is_focus_visible(&self) -> bool

Returns whether the focused target should display a keyboard focus indicator.

Pointer presses hide the indicator without releasing focus. Keyboard input and accessibility focus actions show it; programmatic focus inherits the most recent input mode. Read this during component composition.

pub fn is_captured(&self) -> bool

Returns true when this node has captured focus.

Trait Implementations

impl Clone for FocusRequester

fn clone(&self) -> FocusRequester

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for FocusRequester

impl Debug for FocusRequester

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

Formats the value using the given formatter.

impl Default for FocusRequester

fn default() -> Self

Returns the “default value” for a type.

impl Eq for FocusRequester

impl Hash for FocusRequester

fn hash<__H: Hasher>(&self, state: &mut __H)

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl PartialEq for FocusRequester

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for FocusRequester