Struct Column 

pub struct Column {
    pub title: String,
    pub width: i32,
}

Represents a table column with its title and display width.

Columns define the structure of the table by specifying headers and how much horizontal space each column should occupy. The width is used for text wrapping and alignment within the column boundaries.

Examples

use bubbletea_widgets::table::Column;

// Create a column for names with 20 character width
let name_col = Column::new("Full Name", 20);
assert_eq!(name_col.title, "Full Name");
assert_eq!(name_col.width, 20);

Multiple columns for a complete table structure:

use bubbletea_widgets::table::Column;

let columns = vec![
    Column::new("ID", 8),           // Short numeric ID
    Column::new("Description", 35), // Longer text field
    Column::new("Status", 12),      // Medium status field
];

Width Guidelines

• Numeric columns: 6-10 characters usually sufficient
• Short text: 10-15 characters for codes, statuses
• Names/titles: 20-30 characters for readable display
• Descriptions: 30+ characters for detailed content

Fields

title: String

The display title for this column header.

This text will be shown in the table header row and should be descriptive enough for users to understand the column content.

width: i32

The display width for this column in characters.

This determines how much horizontal space the column occupies. Content longer than this width will be wrapped or truncated depending on the styling configuration.

Implementations

impl Column

pub fn new(title: impl Into<String>, width: i32) -> Self

Creates a new column with the specified title and width.

Arguments

• title - The column header text (accepts any type convertible to String)
• width - The display width in characters (should be positive)

Returns

A new Column instance ready for use in table construction

Examples

use bubbletea_widgets::table::Column;

// Using string literals
let col1 = Column::new("User ID", 10);

// Using String values
let title = String::from("Email Address");
let col2 = Column::new(title, 30);

// Using &str references
let header = "Created Date";
let col3 = Column::new(header, 15);

Creating columns for different data types:

use bubbletea_widgets::table::Column;

let columns = vec![
    Column::new("#", 5),              // Row numbers
    Column::new("Name", 25),          // Person names
    Column::new("Email", 30),         // Email addresses
    Column::new("Joined", 12),        // Dates
    Column::new("Active", 8),         // Boolean status
];

Trait Implementations

impl Clone for Column

fn clone(&self) -> Column

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Column

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

Formats the value using the given formatter.