Struct ListConfig 

#[non_exhaustive]
pub struct ListConfig {

    pub entity: String,
    pub title: Text,
    pub columns: Vec<ListColumn>,
    pub order_by: String,
    pub order_dir: SortDir,
    pub per_page: i64,
    pub id_field: String,
    pub edit_base: Option<String>,
    pub creatable: bool,
    pub filters: Vec<ListFilter>,
    pub deletable: bool,
    pub exportable: bool,
    pub toolbar: Vec<ToolbarButton>,
    pub search: SearchConfig,
    pub per_page_options: Vec<i64>,
    pub no_records_message: Option<Text>,
}

A list view descriptor: which table, which columns, default ordering, page size, and (optionally) where per-row edit links point.

Built with ListConfig::new plus its builder methods. Non-exhaustive, so a struct literal outside this crate cannot freeze the field set at 1.0; that rules out ..Default::default() too, which is why the builders exist.

Fields (Non-exhaustive)

Non-exhaustive structs could have additional fields added in future. Therefore, non-exhaustive structs cannot be constructed in external crates using the traditional Struct { .. } syntax; cannot be matched against without a wildcard ..; and struct update syntax will not work.

entity: String

title: Text

The screen title, localized at render. Serde stays a plain string.

columns: Vec<ListColumn>

order_by: String

order_dir: SortDir

per_page: i64

id_field: String

edit_base: Option<String>

When set, rows link to {edit_base}/{id}/edit.

creatable: bool

Whether to offer a “New” link to {edit_base}/new. A resource that only edits existing records (no create screen) sets this false.

filters: Vec<ListFilter>

Filters offered above the table. Empty hides the bar.

deletable: bool

Whether rows can be selected and deleted from this list. Off by default: a list that shows a log, or records another screen owns, has no business offering it.

exportable: bool

Whether this resource offers an export. Off by default: exporting is a capability a resource opts into, not something every list should carry.

toolbar: Vec<ToolbarButton>

Extra buttons in the toolbar, beside New and the export menu.

search: SearchConfig

per_page_options: Vec<i64>

Page sizes the operator may choose from in the list setup, remembered with their column choice. Empty offers no choice.

no_records_message: Option<Text>

Shown when the list has no records at all. None shows “No records yet.”

Implementations

impl ListConfig

pub fn new( entity: impl Into<String>, title: impl Into<Text>, columns: Vec<ListColumn>, ) -> Self

A list over entity titled title, showing columns.

Everything else takes the defaults below and is opted into through a builder method, so a field added later costs existing descriptors nothing.

pub fn order(self, column: impl Into<String>, dir: SortDir) -> Self

Orders by column in dir rather than newest id first.

pub fn per_page(self, rows: i64) -> Self

pub fn id_field(self, column: impl Into<String>) -> Self

The primary-key column, when it is not id.

pub fn edit_base(self, base: impl Into<String>) -> Self

Links rows to {base}/{id}/edit.

pub fn creatable(self) -> Self

Offers a New link to {edit_base}/new. Opt in, matching the read-only default: a list over a log, or over records another screen owns, should not invite an operator to create one.

pub fn exportable(self) -> Self

Offers CSV and JSON exports of the current query. Opt in: a resource whose rows should not leave the panel simply never calls this, and the route is not registered for it.

pub fn filters(self, filters: Vec<ListFilter>) -> Self

pub fn deletable(self) -> Self

Lets rows be selected and deleted. Off by default: a list showing a log, or records another screen owns, has no business offering it.

pub fn toolbar(self, buttons: Vec<ToolbarButton>) -> Self

pub fn search(self, search: SearchConfig) -> Self

pub fn per_page_options(self, sizes: Vec<i64>) -> Self

pub fn no_records_message(self, text: impl Into<Text>) -> Self

Trait Implementations

impl Clone for ListConfig

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ListConfig

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

Formats the value using the given formatter.

impl Default for ListConfig

fn default() -> Self

A minimal list: no columns, newest-id first, 25 to a page, read-only.

Descriptors use this as the tail of a struct literal (..Default::default()) and set only what they mean. A field added here later is then additive for every descriptor rather than breaking it, which three consecutive additions made the case for.

impl Serialize for ListConfig

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

where __S: Serializer,

Serialize this value into the given Serde serializer.