Struct KeyBindings 

pub struct KeyBindings {

    pub move_up: Vec<KeyCombo>,
    pub move_down: Vec<KeyCombo>,
    pub move_left: Vec<KeyCombo>,
    pub move_right: Vec<KeyCombo>,
    pub move_line_start: Vec<KeyCombo>,
    pub move_line_end: Vec<KeyCombo>,
    pub delete_char_before: Vec<KeyCombo>,
    pub delete_char_at: Vec<KeyCombo>,
    pub kill_line: Vec<KeyCombo>,
    pub insert_newline: Vec<KeyCombo>,
    pub submit: Vec<KeyCombo>,
    pub interrupt: Vec<KeyCombo>,
    pub quit: Vec<KeyCombo>,
    pub force_quit: Vec<KeyCombo>,
    pub enter_exit_mode: Vec<KeyCombo>,
    pub exit_timeout_secs: u64,
    pub select: Vec<KeyCombo>,
    pub cancel: Vec<KeyCombo>,
}

Key binding configuration.

Specifies which key combinations trigger which actions. Multiple key combinations can be assigned to the same action.

The default is bare_minimum() which only provides basic functionality. Apps should explicitly choose their bindings:

• emacs() for full Emacs-style bindings
• minimal() for simple arrow-key navigation

Fields

move_up: Vec<KeyCombo>

Move cursor up.

move_down: Vec<KeyCombo>

Move cursor down.

move_left: Vec<KeyCombo>

Move cursor left.

move_right: Vec<KeyCombo>

Move cursor right.

move_line_start: Vec<KeyCombo>

Move to line start.

move_line_end: Vec<KeyCombo>

Move to line end.

delete_char_before: Vec<KeyCombo>

Delete char before cursor.

delete_char_at: Vec<KeyCombo>

Delete char at cursor.

kill_line: Vec<KeyCombo>

Kill to end of line.

insert_newline: Vec<KeyCombo>

Insert newline in multi-line input.

submit: Vec<KeyCombo>

Submit message.

interrupt: Vec<KeyCombo>

Interrupt current request.

quit: Vec<KeyCombo>

Quit immediately (only when input empty and no modal is blocking).

force_quit: Vec<KeyCombo>

Force quit (works even in modals).

enter_exit_mode: Vec<KeyCombo>

Enter exit confirmation mode (requires pressing twice to exit).

exit_timeout_secs: u64

Timeout in seconds for exit confirmation mode.

select: Vec<KeyCombo>

Select/confirm in widgets (Enter, Space).

cancel: Vec<KeyCombo>

Cancel/close in widgets (Esc).

Implementations

impl KeyBindings

pub fn bare_minimum() -> Self

Bare minimum bindings - only Esc to quit.

This is the default when no bindings are specified. Apps should explicitly choose their bindings (e.g., emacs() or minimal()).

Only provides:

• Esc to quit (when input is empty)
• Ctrl+Q force quit (always works)
• Enter to submit
• Backspace/Delete for basic editing
• Arrow keys for navigation

pub fn emacs() -> Self

Emacs-style bindings.

Full-featured bindings for power users:

• Ctrl+P/N/B/F for navigation
• Ctrl+A/E for line start/end
• Ctrl+K to kill line
• Ctrl+D for exit mode (or delete char if not empty)
• Esc to interrupt

pub fn minimal() -> Self

Minimal bindings (arrows only, Esc to quit).

This is simpler for users unfamiliar with Emacs:

• Arrow keys only for navigation
• Esc quits (when input empty and no modal)
• No Ctrl key requirements for basic use

pub fn with_move_up(self, combos: Vec<KeyCombo>) -> Self

Set the move up key bindings.

pub fn with_move_down(self, combos: Vec<KeyCombo>) -> Self

Set the move down key bindings.

pub fn with_move_left(self, combos: Vec<KeyCombo>) -> Self

Set the move left key bindings.

pub fn with_move_right(self, combos: Vec<KeyCombo>) -> Self

Set the move right key bindings.

pub fn with_move_line_start(self, combos: Vec<KeyCombo>) -> Self

Set the move to line start key bindings.

pub fn with_move_line_end(self, combos: Vec<KeyCombo>) -> Self

Set the move to line end key bindings.

pub fn with_delete_char_before(self, combos: Vec<KeyCombo>) -> Self

Set the delete char before (backspace) key bindings.

pub fn with_delete_char_at(self, combos: Vec<KeyCombo>) -> Self

Set the delete char at (delete) key bindings.

pub fn with_kill_line(self, combos: Vec<KeyCombo>) -> Self

Set the kill line key bindings.

pub fn with_insert_newline(self, combos: Vec<KeyCombo>) -> Self

Set the insert newline key bindings.

pub fn with_submit(self, combos: Vec<KeyCombo>) -> Self

Set the submit key bindings.

pub fn with_interrupt(self, combos: Vec<KeyCombo>) -> Self

Set the interrupt key bindings.

pub fn with_quit(self, combos: Vec<KeyCombo>) -> Self

Set the quit key bindings.

pub fn with_force_quit(self, combos: Vec<KeyCombo>) -> Self

Set the force quit key bindings.

pub fn with_enter_exit_mode(self, combos: Vec<KeyCombo>) -> Self

Set the enter exit mode key bindings.

pub fn with_exit_timeout_secs(self, secs: u64) -> Self

Set the exit timeout in seconds.

pub fn with_select(self, combos: Vec<KeyCombo>) -> Self

Set the select key bindings (for widget selection).

pub fn with_cancel(self, combos: Vec<KeyCombo>) -> Self

Set the cancel key bindings (for widget cancellation).

pub fn without_exit_mode(self) -> Self

Disable exit mode (sets enter_exit_mode to empty).

pub fn without_quit(self) -> Self

Disable quit binding (sets quit to empty).

pub fn without_force_quit(self) -> Self

Disable force quit binding (sets force_quit to empty).

pub fn without_interrupt(self) -> Self

Disable interrupt binding (sets interrupt to empty).

pub fn without_kill_line(self) -> Self

Disable kill line binding (sets kill_line to empty).

pub fn without_insert_newline(self) -> Self

Disable insert newline binding (sets insert_newline to empty).

pub fn add_move_up(self, combo: KeyCombo) -> Self

Add a key combo to the move up bindings.

pub fn add_move_down(self, combo: KeyCombo) -> Self

Add a key combo to the move down bindings.

pub fn add_move_left(self, combo: KeyCombo) -> Self

Add a key combo to the move left bindings.

pub fn add_move_right(self, combo: KeyCombo) -> Self

Add a key combo to the move right bindings.

pub fn add_quit(self, combo: KeyCombo) -> Self

Add a key combo to the quit bindings.

pub fn add_submit(self, combo: KeyCombo) -> Self

Add a key combo to the submit bindings.

pub fn add_interrupt(self, combo: KeyCombo) -> Self

Add a key combo to the interrupt bindings.

pub fn add_enter_exit_mode(self, combo: KeyCombo) -> Self

Add a key combo to the enter exit mode bindings.

pub fn add_force_quit(self, combo: KeyCombo) -> Self

Add a key combo to the force quit bindings.

pub fn add_select(self, combo: KeyCombo) -> Self

Add a key combo to the select bindings.

pub fn add_cancel(self, combo: KeyCombo) -> Self

Add a key combo to the cancel bindings.

Trait Implementations

impl Clone for KeyBindings

fn clone(&self) -> KeyBindings

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for KeyBindings

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

Formats the value using the given formatter.

impl Default for KeyBindings

fn default() -> Self

Returns the “default value” for a type.