Struct Styles 

pub struct Styles {
    pub header: Style,
    pub cell: Style,
    pub selected: Style,
}

Visual styling configuration for table rendering.

This struct defines the appearance of different table elements including headers, regular cells, and selected rows. Each style can control colors, padding, borders, and text formatting using the lipgloss styling system.

Examples

use bubbletea_widgets::table::Styles;
use lipgloss_extras::prelude::*;

// Create custom styling
let styles = Styles {
    header: Style::new()
        .bold(true)
        .background(Color::from("#2563eb"))
        .foreground(Color::from("#ffffff"))
        .padding(0, 1, 0, 1),
    cell: Style::new()
        .padding(0, 1, 0, 1)
        .foreground(Color::from("#374151")),
    selected: Style::new()
        .bold(true)
        .background(Color::from("#10b981"))
        .foreground(Color::from("#ffffff")),
};

Using styles with a table:

use bubbletea_widgets::table::{Model, Column, Styles};
use lipgloss_extras::prelude::*;

let mut table = Model::new(vec![Column::new("Name", 20)]);
table.styles = Styles {
    header: Style::new().bold(true).background(Color::from("blue")),
    cell: Style::new().padding(0, 1, 0, 1),
    selected: Style::new().background(Color::from("green")),
};

Styling Guidelines

• Headers: Usually bold with distinct background colors
• Cells: Minimal styling with consistent padding for readability
• Selected: High contrast colors to clearly indicate selection
• Padding: padding(top, right, bottom, left) for consistent spacing

Fields

header: Style

Style for table header cells.

Applied to the first row containing column titles. Typically uses bold text and distinct background colors to differentiate from data rows.

cell: Style

Style for regular data cells.

Applied to all non-selected data rows. Should provide good readability with appropriate padding and neutral colors.

selected: Style

Style for the currently selected row.

Applied to highlight the active selection. Should use high contrast colors to clearly indicate which row is selected.

Trait Implementations

impl Clone for Styles

fn clone(&self) -> Styles

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Styles

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

Formats the value using the given formatter.

impl Default for Styles

fn default() -> Self

Creates default table styling with reasonable visual defaults.

The default styles provide:

• Header: Bold text with padding for clear column identification
• Cell: Simple padding for consistent data alignment
• Selected: Bold text with a distinct foreground color (#212 - light purple)

Examples

use bubbletea_widgets::table::{Styles, Model, Column};

// Using default styles
let table = Model::new(vec![Column::new("Data", 20)]);
// table.styles is automatically set to Styles::default()

// Explicitly using defaults
let styles = Styles::default();

Style Details

• Header padding: (0, 1, 0, 1) adds horizontal spacing
• Cell padding: (0, 1, 0, 1) maintains consistent alignment
• Selected color: "212" is a light purple that works on most terminals