Struct RelationColumn 

pub struct RelationColumn<M> { /* private fields */ }

A column showing the record of a Deferred belongs_to or has_one field as text, or the records of a has_many one (list), which declares the field’s include so every page that renders it loads them.

use tablo_core::{RelationColumn, relation};

RelationColumn::new(relation!(Post.author), |a: &Author| a.name.clone());

The header and the column’s name are the field’s name, capitalized, until label replaces both. A nullable field holding no record renders empty. The column neither searches nor sorts.

The include loads the related row through Toasty alone: the related resource’s query and policy do not apply, so a soft-deleted or hidden record shows.

Implementations

impl<M> RelationColumn<M>

where M: Model,

pub fn new<T>( relation: RelationLens<M, impl ToOneRelation<T> + 'static>, project: impl Fn(&T) -> String + Send + Sync + 'static, ) -> Self

where M: 'static,

Declare a column rendering project of the record relation loads.

pub fn of<S>( relation: RelationLens<M, impl ToOneRelation<S::Model> + 'static>, ) -> Self

where S: OptionSource, M: 'static,

Declare a column showing the record relation loads by S’s label: for a resource, the record_title its detail page is titled with.

use tablo_core::{RelationColumn, relation};

RelationColumn::of::<AuthorResource>(relation!(Post.author));

pub fn list<S>(relation: RelationLens<M, Deferred<Vec<S::Model>>>) -> Self

where S: OptionSource, M: 'static,

Declare a column listing the records a has_many relation loads, a many-to-many #[has_many(via = ..)] one included, each by S’s label, joined by commas, but the ones S does not let the user view.

use tablo_core::{RelationColumn, relation};

RelationColumn::list::<TagResource>(relation!(Post.tags));

impl<M> RelationColumn<M>

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

Replace the label the field’s name gives it, and name the column after the label, as a ComputedColumn is: two columns over one relation need two labels.

pub fn width(self, width: ColumnWidth) -> Self

Declare this column’s width.

Trait Implementations

impl<M> Clone for RelationColumn<M>

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<M> Column<M> for RelationColumn<M>

where M: Model + Send + Sync + 'static,

fn name(&self) -> &str

The column’s identifier, distinct within its table.

fn label(&self) -> &str

The header text.

fn text(&self, cx: &Cx, row: &M) -> String

The row’s value as plain text.

fn column_width(&self) -> ColumnWidth

The width the column claims.

fn includes(&self) -> Includes<M>

The relations text, cell and entry read.

fn cell<'a>(&self, cx: &'a Cx, row: &M) -> BoxView<'a>

The row’s table cell.

fn entry<'a>(&self, cx: &'a Cx, row: &M) -> BoxView<'a>

The record’s entry on a detail page: the label over the cell.

fn is_searchable(&self) -> bool

Whether the column joins the table’s search.

fn search_expr(&self, _term: &str) -> Option<Expr<bool>>

The predicate a search for term adds.

fn is_sortable(&self) -> bool

Whether the header links to a sort on this column.

fn order_by(&self, _descending: bool) -> Option<OrderByExpr>

The ordering a sort on this column applies.

impl<M> Debug for RelationColumn<M>

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

Formats the value using the given formatter.

impl<M> IntoColumns<M> for RelationColumn<M>

where Self: Column<M> + 'static,

impl<M> IntoDetail<M> for RelationColumn<M>

where Self: Column<M> + 'static,

fn into_detail(self) -> Detail<M>