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.

sortable orders by the stored column, so a type a driver stores as text sorts by its spelling: a decimal column on SQLite, MySQL or Turso lists 10.00, 100, 9.50. The ModelColumns derive leaves a type that is not SORTABLE unsortable.

A column presents its value as a badge, in a color, with a muted description line under it, or as a right-aligned numeric or money amount:

use tablo_core::{Currency, TextColumn, lens};

TextColumn::new(lens!(Order.number)).description(|order: &Order| order.customer.clone());
TextColumn::new(lens!(Order.status)).badge();
TextColumn::new(lens!(Order.total_cents)).money(Currency::USD.minor_units());

A cell also links to a url, shows a tooltip, cuts a long value to a limit, offers a copyable button, shows an icon before the value, and a placeholder for an empty one:

use tablo_core::{Reads, TextColumn, lens};

TextColumn::new(lens!(User.email))
    .url(|user: &User| Some(format!("mailto:{}", user.email)))
    .reading(Reads::nothing())
    .copyable();
TextColumn::new(lens!(User.bio)).limit(40);
TextColumn::new(lens!(User.phone)).placeholder("No phone");

A closure over the row, a description, a url, a tooltip or a money_by, may read any field, so a resource that restricts a field refuses the column until reading declares the ones they read.

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<L: Into<Text>>( self, format: impl Fn(&T) -> L + Send + Sync + 'static, ) -> Self

Render the field’s value through format: a String, or a Text the request’s locale spells.

pub fn badge(self) -> Self

Show the value as a badge, with a dot in its color: an Options enum’s #[option(color = "…")], or the color declared here.

pub fn color( self, color: impl Fn(&T) -> Option<Color> + Send + Sync + 'static, ) -> Self

Color the value: its badge’s dot, or its text when it is no badge.

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

Show description(row) as a muted line under the value, such as a customer’s email under their name. Search, sort and export read the value alone.

pub fn url( self, url: impl Fn(&M) -> Option<String> + Send + Sync + 'static, ) -> Self

Link the value to url(row), or show it unlinked when that is None. The link takes a relative URL or an http, https, mailto or tel one; any other scheme, such as javascript:, leaves the value unlinked.

pub fn open_url_in_new_tab(self) -> Self

Open the url in a new tab.

pub fn tooltip( self, tooltip: impl Fn(&M) -> Option<String> + Send + Sync + 'static, ) -> Self

Show tooltip(row) when the pointer rests on the value.

pub fn limit(self, chars: usize) -> Self

Show at most chars characters of the value, then an ellipsis; the whole value shows when the pointer rests on it, unless a tooltip says otherwise. Search, sort and export read the whole value.

pub fn copyable(self) -> Self

Follow the value with a button copying it to the clipboard, which needs JavaScript.

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

Show placeholder for an empty value, in place of a dash. An export writes the empty value.

pub fn icon( self, icon: impl Fn(&T) -> Option<IconData> + Send + Sync + 'static, ) -> Self

Show icon(value) before the value, in its color, replacing a badge’s dot.

pub fn reading(self, reads: Reads<M>) -> Self

Declare the fields the closures over the row read, beside the column’s own: the description, url, tooltip and money_by.

pub fn weight(self, weight: FontWeight) -> Self

Render the value in weight, such as a product’s name in FontWeight::Medium. A badge keeps its own weight.

pub fn align(self, alignment: Alignment) -> Self

Align the header and the cells.

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

Replace the label the field’s name gives it.

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

Declare this column’s width.

pub fn toggleable(self) -> Self

Let each reader hide this column from their list; it starts shown.

pub fn hidden_by_default(self) -> Self

Let each reader show this column in their list; it starts hidden.

pub fn sortable(self) -> Self

Make the header a sort link.

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

where M: Model, T: Numeric + 'static,

pub fn numeric(self, decimals: u8) -> Self

Spell the value as a number with decimals digits after the point and its thousands grouped in the request’s locale, 12,345.60 in English and 12 345,60 in French, aligned to the end with equal-width digits.

pub fn money(self, currency: Currency) -> Self

Spell the value as an amount of currency in the request’s locale, $1,234.50 in English and 1 234,50 $ in French, aligned to the end with equal-width digits.

pub fn money_by( self, currency: impl Fn(&M) -> Currency + Send + Sync + 'static, ) -> Self

Spell the value as an amount of the currency currency(row) names, such as an order’s own, aligned as money aligns it.

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) -> Text

The header text.

fn column_width(&self) -> ColumnWidth

The width the column claims.

fn toggle(&self) -> ColumnToggle

Whether each reader may hide or show the column in their list, and how it starts. A detail page shows every column.

fn reads(&self) -> Option<Reads<M>>

The fields of the row text, cell, entry, search_expr and order_by read, or None when the column does not say.

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

The row’s value as plain text.

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

The row’s table cell.

fn alignment(&self) -> Alignment

Where the header and the cells align their content.

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

The ordering a sort on this column applies, or None when the header does not link to a sort on it. A sortable column answers Some either way.

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 Self: Column<M> + 'static,

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

where Self: Column<M> + 'static,

fn into_detail(self) -> Detail<M>