Struct Action 

pub struct Action { /* private fields */ }

A row or bulk admin action.

Build with Action::new; chain .danger(), .scope(), .confirm(), .permission() to configure. Use Action::delete_selected for the built-in bulk-delete.

Implementations

impl Action

pub fn new<F, Fut>( key: impl Into<String>, label: impl Into<String>, icon: impl Into<String>, f: F, ) -> Self

where F: Fn(ActionInvocation) -> Fut + Send + Sync + 'static, Fut: Future<Output = Result<ActionResult, String>> + Send + 'static,

Create a new action.

key must be ASCII lowercase/digits/underscores/hyphens.

pub fn danger(self) -> Self

Mark this action as danger variant (red styling).

pub fn scope(self, scope: ActionScope) -> Self

Restrict this action to row-only or bulk-only scope.

pub fn confirm(self, message: impl Into<String>) -> Self

Require a confirm dialog before firing. message is shown in the dialog.

pub fn permission(self, codename: impl Into<String>) -> Self

Require a permission codename before this action can run (gaps2 #79).

When set, the admin checks that the acting user holds codename (directly or via a group) before invoking the handler. Superusers bypass the check. If umbral-permissions is not installed, the check is a no-op and any staff user can run the action.

codename should be the full composite key your permissions plugin uses, e.g. "blog.publish_post".

pub fn delete_selected() -> Self

Built-in bulk-delete. The built-in “Delete selected” action.

pub fn restore_selected() -> Self

Built-in “Restore selected” for soft-delete models (gaps2 #35).

Clears deleted_at for the selected rows via [DynQuerySet::restore], moving them back out of the trash into the live changelist. Auto-injected for soft_delete models (see [effective_actions]); a non-soft-delete model never sees it.

pub fn delete_permanently() -> Self

Built-in “Delete permanently” for soft-delete models (gaps2 #35).

Issues a real DELETE via [DynQuerySet::hard_delete], bypassing the soft-delete stamp so the row leaves the table entirely (gone even from with_deleted()). Behind a confirm interstitial. Auto-injected for soft_delete models; a non-soft-delete model never sees it (its delete_selected already deletes for real).

pub fn key(&self) -> &str

The action key (URL-safe identifier).

Trait Implementations

impl Clone for Action

fn clone(&self) -> Action

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Action

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

Formats the value using the given formatter.