Struct ImageColumn 

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

A column of a String field holding an uploaded image’s path, rendered as a thumbnail.

tablo_core::ImageColumn::new(tablo_core::lens!(Product.image)).circular();

A rooted path, such as an upload’s, shows as a 40px square thumbnail; an empty value shows the table’s dash, and any other value its text. An absolute http(s) URL shows as an image only once remote allows it.

Implementations

impl<M, T> ImageColumn<M, T>

where M: Model,

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

where T: Field<Inner = String>,

Bind the column to the String or Option<String> field lens reads.

pub fn size(self, pixels: u16) -> Self

Show the thumbnail pixels wide and tall.

pub fn circular(self) -> Self

Crop the thumbnail to a circle, for an avatar.

pub fn remote(self) -> Self

Also show an absolute http(s) URL as an image. Every browser that renders the table then loads it from that host as the page opens, so whoever can write the field learns who views the list, and when: allow it for a field only trusted users write.

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.

Trait Implementations

impl<M, T> Clone for ImageColumn<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 ImageColumn<M, T>

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

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 entry<'a>(&self, cx: &'a Cx, row: &M) -> BoxView<'a>

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

fn alignment(&self) -> Alignment

Where the header and the cells align their content.

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

The predicate a search for term adds, or None when the column does not join the table’s search. A column that joins it answers Some for every non-empty, trimmed term.

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

The relations text, cell and entry read.

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

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

Formats the value using the given formatter.

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

where Self: Column<M> + 'static,

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

where Self: Column<M> + 'static,

fn into_detail(self) -> Detail<M>