Struct TextColumn 

pub struct TextColumn<M, T> { /* private fields */ }

A column of one field, rendered as text and bound through a Lens for sorting and search.

tablo_core::TextColumn::new(tablo_core::lens!(User.name))
    .searchable()
    .sortable();
tablo_core::TextColumn::new(tablo_core::lens!(User.age))
    .sortable()
    .format(|age| format!("{age} years"));

The cell is the value’s FormScalar::to_label, an Options enum’s label or any other type’s form spelling, unless format says otherwise. Only a string field is searchable:

tablo_core::TextColumn::new(tablo_core::lens!(User.age)).searchable();

Implementations

impl<M, T> TextColumn<M, T>

where M: Model,

pub fn new(lens: Lens<M, T>) -> Self

where T: FormScalar + Send + Sync + 'static,

Bind a column to the field lens reads, which must be one field of the model.

pub fn format( self, format: impl Fn(&T) -> String + Send + Sync + 'static, ) -> Self

Render the field’s value through format.

pub fn sortable(self) -> Self

Make the header a sort link.

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

Replace the label the field’s name gives it.

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

Declare this column’s width.

impl<M, T> TextColumn<M, T>

where M: Model + Send + Sync + 'static, T: Field<Inner = String> + Send + Sync + 'static,

pub fn searchable(self) -> Self

Join the table’s search with a substring match on this string field.

Trait Implementations

impl<M, T> Clone for TextColumn<M, T>

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<M, T> Column<M> for TextColumn<M, T>

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

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

A portable, escaped substring match.

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 is_searchable(&self) -> bool

Whether the column joins the table’s search.

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.

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 includes(&self) -> Includes<M>

The relations text, cell and entry read.

impl<M, T> Debug for TextColumn<M, T>

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

Formats the value using the given formatter.

impl<M, T> IntoColumns<M> for TextColumn<M, T>

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

impl<M, T> IntoDetail<M> for TextColumn<M, T>

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

fn into_detail(self) -> Detail<M>