NavigationHelper

Struct NavigationHelper 

Source
pub struct NavigationHelper<'a> { /* private fields */ }
Expand description

Helper for widgets to check navigation keys against configured bindings.

Pass this to widgets so they can respect configured key bindings instead of hardcoding key codes.

§Example

fn handle_key(&mut self, key: KeyEvent, ctx: &WidgetKeyContext) -> WidgetKeyResult {
    if ctx.nav.is_move_up(&key) {
        self.select_previous();
        WidgetKeyResult::Handled
    } else if ctx.nav.is_move_down(&key) {
        self.select_next();
        WidgetKeyResult::Handled
    } else if ctx.nav.is_select(&key) {
        // Handle selection
    } else if ctx.nav.is_cancel(&key) {
        // Handle cancel
    } else {
        WidgetKeyResult::NotHandled
    }
}

Implementations§

Source§

impl<'a> NavigationHelper<'a>

Source

pub fn new(bindings: &'a KeyBindings) -> Self

Create a new navigation helper from key bindings.

Source

pub fn is_move_up(&self, key: &KeyEvent) -> bool

Check if the key matches the move up binding.

Source

pub fn is_move_down(&self, key: &KeyEvent) -> bool

Check if the key matches the move down binding.

Source

pub fn is_move_left(&self, key: &KeyEvent) -> bool

Check if the key matches the move left binding.

Source

pub fn is_move_right(&self, key: &KeyEvent) -> bool

Check if the key matches the move right binding.

Source

pub fn is_select(&self, key: &KeyEvent) -> bool

Check if the key matches the select binding (Enter, Space).

Source

pub fn is_cancel(&self, key: &KeyEvent) -> bool

Check if the key matches the cancel binding (Esc).

Source

pub fn is_submit(&self, key: &KeyEvent) -> bool

Check if the key matches the submit binding (Enter).

Auto Trait Implementations§

§

impl<'a> Freeze for NavigationHelper<'a>

§

impl<'a> RefUnwindSafe for NavigationHelper<'a>

§

impl<'a> Send for NavigationHelper<'a>

§

impl<'a> Sync for NavigationHelper<'a>

§

impl<'a> Unpin for NavigationHelper<'a>

§

impl<'a> UnwindSafe for NavigationHelper<'a>

Blanket Implementations§

Source§

impl<T> Any for T
where T: 'static + ?Sized,

Source§

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more
Source§

impl<T> Borrow<T> for T
where T: ?Sized,

Source§

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more
Source§

impl<T> BorrowMut<T> for T
where T: ?Sized,

Source§

fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more
Source§

impl<T> From<T> for T

Source§

fn from(t: T) -> T

Returns the argument unchanged.

Source§

impl<T> Instrument for T

Source§

fn instrument(self, span: Span) -> Instrumented<Self>

Instruments this type with the provided Span, returning an Instrumented wrapper. Read more
Source§

fn in_current_span(self) -> Instrumented<Self>

Instruments this type with the current Span, returning an Instrumented wrapper. Read more
Source§

impl<T, U> Into<U> for T
where U: From<T>,

Source§

fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

Source§

impl<T> IntoEither for T

Source§

fn into_either(self, into_left: bool) -> Either<Self, Self>

Converts self into a Left variant of Either<Self, Self> if into_left is true. Converts self into a Right variant of Either<Self, Self> otherwise. Read more
Source§

fn into_either_with<F>(self, into_left: F) -> Either<Self, Self>
where F: FnOnce(&Self) -> bool,

Converts self into a Left variant of Either<Self, Self> if into_left(&self) returns true. Converts self into a Right variant of Either<Self, Self> otherwise. Read more
Source§

impl<T, U> TryFrom<U> for T
where U: Into<T>,

Source§

type Error = Infallible

The type returned in the event of a conversion error.
Source§

fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>

Performs the conversion.
Source§

impl<T, U> TryInto<U> for T
where U: TryFrom<T>,

Source§

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.
Source§

fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

Performs the conversion.
Source§

impl<T> WithSubscriber for T

Source§

fn with_subscriber<S>(self, subscriber: S) -> WithDispatch<Self>
where S: Into<Dispatch>,

Attaches the provided Subscriber to this type, returning a WithDispatch wrapper. Read more
Source§

fn with_current_subscriber(self) -> WithDispatch<Self>

Attaches the current default Subscriber to this type, returning a WithDispatch wrapper. Read more