Struct TableState 

pub struct TableState {
    pub prefix: Option<String>,
    pub search: Option<String>,
    pub sort: Option<Sort>,
    pub cursor: Option<Cursor>,
    pub filters: BTreeMap<String, String>,
    pub filters_dropped: bool,
    pub group_by: Option<String>,
    pub delete: Option<String>,
    pub open: Option<bool>,
}

Request-scoped table state, parsed from the list’s URL query.

Fields

prefix: Option<String>

The prefix every parameter of this table carries, or None for a page’s own list.

search: Option<String>

?q= — trimmed and clamped to MAX_QUERY_TERM chars; None when absent or blank.

sort: Option<Sort>

?sort= + ?dir= — None when absent or blank.

cursor: Option<Cursor>

?after= or ?before=.

filters: BTreeMap<String, String>

?f.<name>=<value>, one parameter per active filter, by name. A blank value is no filter.

filters_dropped: bool

Filter parameters the parse dropped.

group_by: Option<String>

?group_by= — field name to group by (in-memory, count summarizer).

delete: Option<String>

?delete= — the row key whose delete dialog opens; never a write.

open: Option<bool>

?open=false — renders the delete dialog closed.

Implementations

impl TableState

pub fn from_cx(cx: &Cx) -> Self

Parse the state from the request in cx: Self::from_query over the request URI’s query. Renders without a request context (e.g. unit tests) get neutral state.

pub fn from_cx_prefixed(cx: &Cx, prefix: &str) -> Self

Self::from_cx for the table whose parameters carry prefix, on a page of several.

pub fn from_query_prefixed(query: &str, prefix: &str) -> Self

Self::from_query for the table whose parameters carry prefix: only the parameters spelled {prefix}.{name} are read, as name, and the parsed state carries the prefix so its links spell the same names.

pub fn from_query(query: &str) -> Self

Parse the state from a URL query (without the leading ?): the one parser behind the GET page and the live shard.

A blank or unknown query parses as neutral state rather than failing the request. A duplicate key keeps its first occurrence, so a repeated filter never vanishes. A blank or dropped filter occurrence is no filter, so a later occurrence of the same filter applies (a dropped one still flags Self::filters_dropped). q is trimmed and clamped to MAX_QUERY_TERM, dir is trimmed before comparing, and at most MAX_FILTERS filters of at most MAX_FILTER_LEN bytes apply. A cursor token is checked later, when it decodes.

The live shard parses a client-owned query, so the parse is linear in its length: only the known keys are remembered.

Trait Implementations

impl Clone for TableState

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 TableState

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

Formats the value using the given formatter.

impl Default for TableState

fn default() -> Self

Returns the “default value” for a type.

impl Eq for TableState

impl PartialEq for TableState

fn eq(&self, other: &Self) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl StructuralPartialEq for TableState