Struct Columns 

pub struct Columns<'a> { /* private fields */ }

A renderable that arranges items in columns.

Implementations

impl<'a> Columns<'a>

pub fn new(items: Vec<Vec<Segment<'a>>>) -> Self

Create a new Columns layout with the given items.

pub fn from_strings(items: &[&'a str]) -> Self

Create columns from strings.

pub fn column_count(self, count: usize) -> Self

Set the number of columns.

pub fn gutter(self, gutter: usize) -> Self

Set the gutter (space between columns).

pub fn expand(self, expand: bool) -> Self

Set whether to expand columns to fill width.

pub fn equal_width(self, equal: bool) -> Self

Set whether columns should have equal width.

pub fn align(self, align: AlignMethod) -> Self

Set alignment within columns.

pub fn padding(self, padding: usize) -> Self

Set padding around each item.

pub fn gutter_style(self, style: Style) -> Self

Set the gutter style.

pub fn max_width(self, width: usize) -> Self

Set a maximum width for the columns layout.

When set, the columns will not expand beyond this width even if more terminal space is available. This prevents excessive whitespace on very wide terminals (e.g., 300+ columns).

Example

let cols = Columns::from_strings(&["A", "B", "C"])
    .max_width(120)  // Never wider than 120 columns
    .expand(true);   // But expand up to that limit

pub fn render(&self, total_width: usize) -> Vec<Vec<Segment<'a>>>

Render the columns to lines of segments.

pub fn render_flat(&self, total_width: usize) -> Vec<Segment<'a>>

Render to a single flat list of segments with newlines.

Trait Implementations

impl<'a> Clone for Columns<'a>

fn clone(&self) -> Columns<'a>

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<'a> Debug for Columns<'a>

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

Formats the value using the given formatter.

impl Default for Columns<'_>

fn default() -> Self

Returns the “default value” for a type.

impl Renderable for Columns<'_>

fn render<'b>( &'b self, _console: &Console, options: &ConsoleOptions, ) -> Vec<Segment<'b>>

Render the object to a list of segments.