Skip to main content

InlinePanelSpec

Struct InlinePanelSpec 

Source
pub struct InlinePanelSpec {
Show 14 fields pub name: String, pub label: String, pub fields: Vec<ExtensionField>, pub min_num: Option<usize>, pub max_num: Option<usize>, pub help: String, pub icon: Option<String>, pub widgets: Vec<Widget>, pub tab: Option<String>, pub row_label: String, pub can_add: bool, pub can_delete: bool, pub can_order: bool, pub per_row: bool,
}
Expand description

One inline panel declaration — a 1-N relation between the page and a child table the handler maintains. See PageTypeHandler::inline_panels. The admin editor renders each row as a card of widgets (any crate::Widget kind: selects, switches, the media chooser…) with add, remove and move up / down, in the Content tab or in a tab of its own (Self::in_tab).

Every row carries its id (when the loaded row has one) in a hidden field, so PageTypeHandler::save_inline_panel can tell existing rows from new ones. A loaded row’s __title key, when set, is shown as the card’s heading.

Fields§

§name: String

Stable identifier — used in form field names (inline__<name>__<row>__<field>). Snake_case conventional.

§label: String

Visible label shown above the panel.

§fields: Vec<ExtensionField>

Per-row field surface. Each entry renders one input per row.

§min_num: Option<usize>

Optional minimum row count (inclusive). When set + the editor submits fewer rows, the save handler logs a warning but doesn’t reject — handlers enforce hard rules themselves.

§max_num: Option<usize>

Optional maximum row count (inclusive).

§help: String

Optional helptext shown beneath the panel header.

§icon: Option<String>

Optional material-symbols icon name.

§widgets: Vec<Widget>

Per-row widgets. When non-empty they replace Self::fields, giving rows every widget kind. Names are the row keys.

§tab: Option<String>

Render the panel in its own editor tab with this label instead of the Content tab. Panels naming the same tab share it.

§row_label: String

What one row is called, e.g. “Cause” (the add button reads “Add cause”).

§can_add: bool

Editors may add rows.

§can_delete: bool

Editors may remove rows.

§can_order: bool

Editors may reorder rows (the saved order is the row order).

§per_row: bool

Per-row mode: the tab lists only each row’s title; a card’s fields load when it is opened, it saves with its own Save button, and add, remove and reorder take effect at once. The page’s Save sends nothing for this panel. Uses the *_inline_row* hooks instead of PageTypeHandler::load_inline_panel / save_inline_panel. For panels with many rows.

Implementations§

Source§

impl InlinePanelSpec

Source

pub fn new( name: impl Into<String>, label: impl Into<String>, fields: Vec<ExtensionField>, ) -> Self

Smallest valid spec — (name, label, fields). Helpers below add min / max / help / icon fluently.

Source

pub fn per_row(self) -> Self

Per-row mode — see Self::per_row.

Source

pub fn with_widgets( name: impl Into<String>, label: impl Into<String>, widgets: Vec<Widget>, ) -> Self

A panel whose rows are full widgets — see Self::widgets.

Source

pub fn in_tab(self, tab: impl Into<String>) -> Self

Show the panel in its own editor tab labelled tab.

Source

pub fn with_row_label(self, label: impl Into<String>) -> Self

Name one row, e.g. “Cause”.

Source

pub fn allow(self, add: bool, delete: bool, order: bool) -> Self

Which row operations editors get. A panel whose rows another system owns sets add and delete to false.

Source

pub fn row_widgets(&self) -> Vec<Widget>

The widgets one row renders: Self::widgets, or the legacy Self::fields converted.

Source

pub fn with_min(self, min: usize) -> Self

Source

pub fn with_max(self, max: usize) -> Self

Source

pub fn with_help(self, help: impl Into<String>) -> Self

Source

pub fn with_icon(self, icon: impl Into<String>) -> Self

Trait Implementations§

Source§

impl Clone for InlinePanelSpec

Source§

fn clone(&self) -> Self

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 InlinePanelSpec

Source§

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

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

impl<'de> Deserialize<'de> for InlinePanelSpec

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 InlinePanelSpec

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

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> From<T> for T

Source§

fn from(t: T) -> T

Returns the argument unchanged.

Source§

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

Source§

fn from_ref(input: &T) -> T

Converts to this type from a reference to the input type.
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<Unshared, Shared> IntoShared<Shared> for Unshared
where Shared: FromUnshared<Unshared>,

Source§

fn into_shared(self) -> Shared

Creates a shared type from an unshared type.
Source§

impl<T> Pointable for T

Source§

const ALIGN: usize

The alignment of pointer.
Source§

type Init = T

The type for initializers.
Source§

unsafe fn init(init: <T as Pointable>::Init) -> usize

Initializes a with the given initializer. Read more
Source§

unsafe fn deref<'a>(ptr: usize) -> &'a T

Dereferences the given pointer. Read more
Source§

unsafe fn deref_mut<'a>(ptr: usize) -> &'a mut T

Mutably dereferences the given pointer. Read more
Source§

unsafe fn drop(ptr: usize)

Drops the object pointed to by the given pointer. Read more
Source§

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

Source§

fn and<P, B, E>(self, other: P) -> And<T, P>
where T: Sized + Policy<B, E>, P: Policy<B, E>,

Create a new Policy that returns Action::Follow only if self and other return Action::Follow. Read more
Source§

fn or<P, B, E>(self, other: P) -> Or<T, P>
where T: Sized + Policy<B, E>, P: Policy<B, E>,

Create a new Policy that returns Action::Follow if either self or other returns Action::Follow. Read more
Source§

impl<T> Same for T

Source§

type Output = T

Should always be Self
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 = !

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

fn try_from(value: U) -> Result<T, !>

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<V, T> VZip<V> for T
where V: MultiLane<T>,

Source§

fn vzip(self) -> V

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