Skip to main content

WidgetAction

Enum WidgetAction 

Source
pub enum WidgetAction {
    FocusAdvance {
        delta: i32,
    },
    Activate,
    SelectMove {
        delta: i32,
    },
    TextInputKey {
        key: String,
    },
    TextInputChar {
        text: String,
    },
    Key {
        key: String,
    },
}
Expand description

Action a plugin can request the widget runtime to perform on a mounted panel. Bundled into a single WidgetCommand PluginCommand so the plugin’s TypeScript layer exposes one routing method (editor.widgetCommand(panel_id, action)) rather than a fanout of per-key IPC.

All actions target the panel’s currently focused widget (the host tracks focus per panel). They are fired by the plugin’s mode bindings — Tab → FocusAdvance{+1}, Enter → Activate, Up/Down → SelectMove{±1}, Backspace → TextInputKey{"Backspace"}, printable chars (via mode_text_input) → TextInputChar{"x"}.

Variants§

§

FocusAdvance

Cycle focus to the next (delta=+1) or previous (delta=-1) tabbable widget in declaration order. Wraps at the ends.

Fields

§delta: i32
§

Activate

“Activate” the focused widget — fires a semantic event keyed on widget kind: Buttonwidget_event { event_type: "activate" }; Togglewidget_event { event_type: "toggle", payload: { checked: !old } }. No-op for other kinds.

§

SelectMove

Move the focused List’s selection by delta. Plugins listen for widget_event { event_type: "select" } to mirror the new index into their model. No-op when the focused widget isn’t a List.

Fields

§delta: i32
§

TextInputKey

Apply a non-printable editing key to the focused TextInput: "Backspace", "Delete", "Left", "Right", "Home", "End". Host computes the new value/cursor and fires widget_event { event_type: "change", payload: { value, cursorByte } }. No-op when the focused widget isn’t a TextInput or the key isn’t recognised.

Fields

§

TextInputChar

Append printable text to the focused TextInput at the current cursor position. Used for the mode_text_input fall-through path. Fires widget_event as for TextInputKey.

Fields

§text: String
§

Key

“Smart” keystroke dispatch — the host routes based on the focused widget’s kind without the plugin needing to know what’s focused. This is the recommended path for plugin mode bindings: bind every relevant key to one handler that calls editor.widgetCommand(panel_id, key("Tab")) etc.

Dispatch table:

KeyTextInputTextAreaToggle / ButtonListTree(no focus)
Tabfocus +1focus +1focus +1focus +1focus +1no-op
Shift+Tabfocus -1focus -1focus -1focus -1focus -1no-op
Backspace / Deletetext-edittext-editno-opno-opno-opno-op
Home / Endtext-editline-start / -endno-opno-opno-opno-op
Lefttext-edittext-editno-opno-opcollapse / parentno-op
Righttext-edittext-editno-opno-opexpandno-op
Upno-opline upno-opselect -1select -1 (visible)no-op
Downno-opline downno-opselect +1select +1 (visible)no-op
Enterfocus +1insert \nactivateactivateactivateno-op
Spacechar “ “char “ “activateactivateactivateno-op
(anything else)no-opno-opno-opno-opno-opno-op

“no-op” still returns successfully — plugins can rely on the command not erroring when the focused widget can’t handle the key. Plugins that want to fall back to their own behaviour when the widget doesn’t claim a key should bind those keys to plugin-specific handlers instead.

Fields

Trait Implementations§

Source§

impl Clone for WidgetAction

Source§

fn clone(&self) -> WidgetAction

Returns a duplicate of the value. Read more
1.0.0 (const: unstable) · Source§

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

Performs copy-assignment from source. Read more
Source§

impl Debug for WidgetAction

Source§

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

Formats the value using the given formatter. Read more
Source§

impl<'de> Deserialize<'de> for WidgetAction

Source§

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>
where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer. Read more
Source§

impl Serialize for WidgetAction

Source§

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>
where __S: Serializer,

Serialize this value into the given Serde serializer. Read more
Source§

impl TS for WidgetAction

Source§

type WithoutGenerics = WidgetAction

If this type does not have generic parameters, then WithoutGenerics should just be Self. If the type does have generic parameters, then all generic parameters must be replaced with a dummy type, e.g ts_rs::Dummy or ().
The only requirement for these dummy types is that EXPORT_TO must be None. Read more
Source§

type OptionInnerType = WidgetAction

If the implementing type is std::option::Option<T>, then this associated type is set to T. All other implementations of TS should set this type to Self instead.
Source§

fn ident(cfg: &Config) -> String

Identifier of this type, excluding generic parameters.
Source§

fn docs() -> Option<String>

JSDoc comment to describe this type in TypeScript - when TS is derived, docs are automatically read from your doc comments or #[doc = ".."] attributes
Source§

fn name(cfg: &Config) -> String

Name of this type in TypeScript, including generic parameters
Source§

fn decl_concrete(cfg: &Config) -> String

Declaration of this type using the supplied generic arguments. The resulting TypeScript definition will not be generic. For that, see TS::decl(). If this type is not generic, then this function is equivalent to TS::decl().
Source§

fn decl(cfg: &Config) -> String

Declaration of this type, e.g. type User = { user_id: number, ... }. This function will panic if the type has no declaration. Read more
Source§

fn inline(cfg: &Config) -> String

Formats this types definition in TypeScript, e.g { user_id: number }. This function will panic if the type cannot be inlined.
Source§

fn inline_flattened(cfg: &Config) -> String

Flatten a type declaration. This function will panic if the type cannot be flattened.
Source§

fn visit_generics(v: &mut impl TypeVisitor)
where Self: 'static,

Iterates over all type parameters of this type.
Source§

fn output_path() -> Option<PathBuf>

Returns the output path to where T should be exported, relative to the output directory. The returned path does not include any base directory. Read more
Source§

fn visit_dependencies(v: &mut impl TypeVisitor)
where Self: 'static,

Iterates over all dependency of this type.
Source§

fn dependencies(cfg: &Config) -> Vec<Dependency>
where Self: 'static,

Resolves all dependencies of this type recursively.
Source§

fn export(cfg: &Config) -> Result<(), ExportError>
where Self: 'static,

Manually export this type to the filesystem. To export this type together with all of its dependencies, use TS::export_all. Read more
Source§

fn export_all(cfg: &Config) -> Result<(), ExportError>
where Self: 'static,

Manually export this type to the filesystem, together with all of its dependencies. To export only this type, without its dependencies, use TS::export. Read more
Source§

fn export_to_string(cfg: &Config) -> Result<String, ExportError>
where Self: 'static,

Manually generate bindings for this type, returning a String. This function does not format the output, even if the format feature is enabled. Read more

Auto Trait Implementations§

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> CloneToUninit for T
where T: Clone,

Source§

unsafe fn clone_to_uninit(&self, dest: *mut u8)

🔬This is a nightly-only experimental API. (clone_to_uninit)
Performs copy-assignment from self to dest. Read more
Source§

impl<T> DeserializeOwned for T
where T: for<'de> Deserialize<'de>,

Source§

impl<T> DynClone for T
where T: Clone,

Source§

fn __clone_box(&self, _: Private) -> *mut ()

Source§

impl<T> From<T> for T

Source§

fn from(t: T) -> T

Returns the argument unchanged.

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> ToOwned for T
where T: Clone,

Source§

type Owned = T

The resulting type after obtaining ownership.
Source§

fn to_owned(&self) -> T

Creates owned data from borrowed data, usually by cloning. Read more
Source§

fn clone_into(&self, target: &mut T)

Uses borrowed data to replace owned data, usually by cloning. 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.