Skip to main content

ColumnKind

Enum ColumnKind 

Source
#[non_exhaustive]
pub enum ColumnKind { Text, Identifier, Date, Number, Code, Status, Actions, }
Expand description

What a column holds.

wiki table-model: the kind is what carries a column’s look, and four of the reference table’s six rules were per kind rather than per table. A description states what the column is; each renderer decides what that looks like in its host, from the facts below rather than from the name.

#[non_exhaustive], Width’s reasoning.

Variants (Non-exhaustive)§

This enum is marked as non-exhaustive
Non-exhaustive enums could have additional variants added in future. Therefore, when matching against variants of non-exhaustive enums, an extra wildcard arm must be added to account for any future variants.
§

Text

Prose. Wraps. What a column is when it says nothing else.

§

Identifier

A name a machine made: a fingerprint, a hash, a slug. Monospace, and breaks mid-string rather than widening the table.

§

Date

A point in time. Never wraps, so a date cannot print over its neighbour, and its figures line up down the column.

§

Number

A quantity. Figures line up and the column aligns to its end, so magnitudes compare by length.

§

Code

Source text, one row per line. Monospace and never wrapped. A table holding one is read as code, so its rows are not striped or spaced as records.

§

Status

A state the row is in, drawn as a chip rather than as coloured text.

§

Actions

The row’s controls. Aligns to its end and shrinks to what it holds.

Implementations§

Source§

impl ColumnKind

Source

pub const fn floor(self) -> u16

The narrowest a column of this kind reads at, in ch, when it declares nothing narrower.

A date is ten characters in the form every host writes, and a number cut short is a different number, so the kinds that cannot truncate floor at what they hold. Prose and identifiers wrap or break, so theirs is only enough to be recognisable.

Source

pub const fn holds_minimum(self) -> bool

👎Deprecated since 0.50.1:

a floor binds for every kind; priority decides whether a column gives up room

Which kinds keep their floor rather than truncating when room runs out.

Deprecated in 0.50.1, and answered by nothing. A floor is a floor: Column::floor is documented as the narrowest a column may be before it drops, which is what makeover-tui counts in cells and makeover-immediate budgets in points. A kind-keyed exemption meant makeover-webview alone drew three of the seven kinds under a floor it had just computed for them, because nothing set their shrink to zero and its blanking condition reaches only droppable columns. Measured at 420, MNW’s scan pipeline drew yara, clamav, urlhaus and metadefender as y, c, u, m while the Number columns beside them stood at full width.

It was also the wrong axis. Shrink is distributed in proportion to basis, and an undeclared basis comes from the heading’s length, so between two columns of one priority the one with the shorter heading reached illegibility first. A column’s minimum legible width is not a fact about its label.

What varies by kind is what happens above the floor, which wraps already says. What decides whether a column gives up room at all is its Priority, which is the description’s own word for it. makeover-webview 0.94.0 keys the floor on priority, and no renderer calls this.

Kept only because deleting it is a breaking change to a crate carrying links, so it would cascade the whole suite for a predicate with no callers. Delete it at the next breaking bump.

Source

pub const fn aligns_end(self) -> bool

Whether the column aligns to its end rather than its start.

Source

pub const fn wraps(self) -> bool

Whether the column’s text may wrap onto a second line.

An identifier wraps by breaking mid-string, which is still a wrap: the alternative is a fingerprint forcing the table wider than its pane.

Source

pub const fn monospace(self) -> bool

Whether the column is set in the monospace face.

Source

pub const fn tabular(self) -> bool

Whether figures in the column take equal widths.

Trait Implementations§

Source§

impl Clone for ColumnKind

Source§

fn clone(&self) -> Self

Returns a duplicate of the value. Read more
1.0.0 (const: unstable) · Source§

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

Performs copy-assignment from source. Read more
Source§

impl Copy for ColumnKind

Source§

impl Debug for ColumnKind

Source§

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

Formats the value using the given formatter. Read more
Source§

impl Default for ColumnKind

Source§

fn default() -> Self

Returns the “default value” for a type. Read more
Source§

impl Eq for ColumnKind

Source§

impl Hash for ColumnKind

Source§

fn hash<__H: Hasher>(&self, state: &mut __H)

Feeds this value into the given Hasher. Read more
1.3.0 · Source§

fn hash_slice<H>(data: &[Self], state: &mut H)
where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher. Read more
Source§

impl PartialEq for ColumnKind

Source§

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

Equality operator ==. Read more
1.0.0 (const: unstable) · Source§

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

Inequality operator !=. Read more
Source§

impl StructuralPartialEq for ColumnKind

Auto Trait Implementations§

Blanket Implementations§

Source§

impl<T> Any for T
where T: 'static + ?Sized,

Source§

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more
Source§

impl<T> Borrow<T> for T
where T: ?Sized,

Source§

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more
Source§

impl<T> BorrowMut<T> for T
where T: ?Sized,

Source§

fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more
Source§

impl<T> CloneToUninit for T
where T: Clone,

Source§

unsafe fn clone_to_uninit(&self, dest: *mut u8)

🔬This is a nightly-only experimental API. (clone_to_uninit)
Performs copy-assignment from self to dest. Read more
Source§

impl<T> From<T> for T

Source§

fn from(t: T) -> T

Returns the argument unchanged.

Source§

impl<T, U> Into<U> for T
where U: From<T>,

Source§

fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

Source§

impl<T> ToOwned for T
where T: Clone,

Source§

type Owned = T

The resulting type after obtaining ownership.
Source§

fn to_owned(&self) -> T

Creates owned data from borrowed data, usually by cloning. Read more
Source§

fn clone_into(&self, target: &mut T)

Uses borrowed data to replace owned data, usually by cloning. Read more
Source§

impl<T, U> TryFrom<U> for T
where U: Into<T>,

Source§

type Error = !

The type returned in the event of a conversion error.
Source§

fn try_from(value: U) -> Result<T, !>

Performs the conversion.
Source§

impl<T, U> TryInto<U> for T
where U: TryFrom<T>,

Source§

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.
Source§

fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

Performs the conversion.