Struct DockAction 

pub struct DockAction { /* private fields */ }

A dockless command button in the activity rail: it looks and behaves like an activity item, but opens no panel — activating it just runs a closure.

Declared on DockRail::action, so (like the rail’s slots) it is per-view app config, reconstructed each run. A rail action is deliberately more restricted than a real activity: it is never draggable, never hidable, has no “Move to” menu, and is never overflow-parked — it is reserved space. That matches every surveyed precedent (VS Code’s fixed Accounts / Manage cluster; IntelliJ’s stripe, whose only non-tool-window button is IDE-owned chrome).

DockRail::new(DockSide::Leading).action(
    DockAction::new(
        DockActionId::named("app.settings"),
        lit!("Settings"),
        || IconWidget::gear(),
        |ctx| ctx.send_intent(Intent::new("app.settings")),
    )
    .placement(DockActionPlacement::Pinned),
)

Implementations

impl DockAction

pub fn new( id: DockActionId, label: impl Into<LocalizedString>, icon: impl Fn() -> IconWidget + 'static, on_activate: impl Fn(&mut EventContext<'_>) + 'static, ) -> Self

Declare a rail action. Defaults to DockActionPlacement::End, enabled, untoggled, with the label as its hover tooltip.

pub fn placement(self, placement: DockActionPlacement) -> Self

Where the action sits along the rail. See DockActionPlacement.

pub fn tooltip(self, tooltip: impl Into<LocalizedString>) -> Self

Override the hover tooltip (defaults to the label). Ignored in Icon + Label rail mode, which paints the label inline instead.

pub fn enabled(self, enabled: impl Into<Prop<bool>>) -> Self

Enable / disable the action. Accepts a bool or a Signal<bool>.

pub fn toggled(self, state: Signal<bool>) -> Self

Paint the selected surface while state is true — the same highlight an open activity gets. Reflect-only: activating the action does not write state; on_activate must.

pub fn id(&self) -> DockActionId

The action’s id.

Trait Implementations

impl Clone for DockAction

fn clone(&self) -> DockAction

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for DockAction

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

Formats the value using the given formatter.