Struct ListStyles 

pub struct ListStyles {

    pub title_bar: Style,
    pub title: Style,
    pub spinner: Style,
    pub filter_prompt: Style,
    pub filter_cursor: Style,
    pub default_filter_character_match: Style,
    pub status_bar: Style,
    pub status_empty: Style,
    pub status_bar_active_filter: Style,
    pub status_bar_filter_count: Style,
    pub no_items: Style,
    pub pagination_style: Style,
    pub help_style: Style,
    pub active_pagination_dot: Style,
    pub inactive_pagination_dot: Style,
    pub arabic_pagination: Style,
    pub divider_dot: Style,
}

Comprehensive styling configuration for all list component UI elements.

This struct contains styling definitions for every visual element in a list component, from the title bar and items to pagination and help text. All styles use adaptive colors that automatically adjust to the terminal’s light or dark theme.

Style Categories

The styles are organized into logical categories:

Header and Title

• title_bar: Container for the list title
• title: The list title text styling

Filtering and Input

• filter_prompt: The “Filter:” prompt text
• filter_cursor: Cursor/caret in filter input
• default_filter_character_match: Character-level match highlighting

Status and Information

• status_bar: Main status bar container
• status_empty: Status when list is empty
• status_bar_active_filter: Active filter indicator
• status_bar_filter_count: Filter result count
• no_items: “No items” message

Pagination and Navigation

• pagination_style: Pagination area container
• active_pagination_dot: Current page indicator (•)
• inactive_pagination_dot: Other page indicators (•)
• arabic_pagination: Numeric pagination (1, 2, 3…)
• divider_dot: Separator between elements ( • )

Interactive Elements

• spinner: Loading/processing indicator
• help_style: Help text area

Adaptive Color System

All default styles use AdaptiveColor which provides different colors for light and dark terminal themes:

• Light themes: Darker text on light backgrounds
• Dark themes: Lighter text on dark backgrounds

Examples

use bubbletea_widgets::list::style::ListStyles;
use lipgloss_extras::prelude::*;

// Start with default adaptive styles
let mut styles = ListStyles::default();

// Customize title with branded colors
styles.title = Style::new()
    .background(Color::from("#7D56F4"))
    .foreground(Color::from("#FFFFFF"))
    .bold(true)
    .padding(0, 1, 0, 1);

// Make filter prompt more prominent
styles.filter_prompt = Style::new()
    .foreground(AdaptiveColor { Light: "#059669", Dark: "#10B981" })
    .bold(true);

// Use subtle pagination
styles.pagination_style = Style::new()
    .foreground(AdaptiveColor { Light: "#9CA3AF", Dark: "#6B7280" })
    .padding_left(2);

Integration

This struct is typically used with Model to configure the entire list appearance:

use bubbletea_widgets::list::{Model, DefaultItem, DefaultDelegate, style::ListStyles};

let items = vec![DefaultItem::new("Item 1", "Description 1")];
let delegate = DefaultDelegate::new();
let list: Model<DefaultItem> = Model::new(items, delegate, 80, 24);

// Custom styles can be created and configured
let mut custom_styles = ListStyles::default();
custom_styles.title = custom_styles.title.bold(true);
// Note: Styles would be applied through constructor or builder pattern

Fields

title_bar: Style

Style for the title bar container.

title: Style

Style for the list title text.

spinner: Style

Style for spinner glyphs.

filter_prompt: Style

Style for the filter prompt label.

filter_cursor: Style

Style for the filter cursor/caret.

default_filter_character_match: Style

Style for default filter character highlight.

status_bar: Style

Style for the status bar container.

status_empty: Style

Style for the status bar when the list is empty.

status_bar_active_filter: Style

Style for active filter text in the status bar.

status_bar_filter_count: Style

Style for filter match count in the status bar.

no_items: Style

Style for the “No items” message.

pagination_style: Style

Style for pagination area.

help_style: Style

Style for help text area.

active_pagination_dot: Style

Style for the active pagination dot.

inactive_pagination_dot: Style

Style for the inactive pagination dot.

arabic_pagination: Style

Style for arabic numerals in pagination.

divider_dot: Style

Style for the divider dot between elements.

Trait Implementations

impl Clone for ListStyles

fn clone(&self) -> ListStyles

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ListStyles

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

Formats the value using the given formatter.

impl Default for ListStyles

fn default() -> Self

Creates default list styles matching the Go bubbles library appearance.

The default styles provide a professional, accessible appearance with:

• Adaptive colors that automatically adjust to terminal themes
• Consistent typography with proper spacing and alignment
• High contrast for accessibility and readability
• Visual hierarchy with appropriate emphasis and subdued elements

Color Palette

The default styles use a carefully chosen adaptive color palette:

Primary Colors

• Title: Fixed colors (background: #3E (purple), text: #E6 (light))
• Active elements: Bright colors for focus and selection

Adaptive Colors

• Normal text: Light: dark text, Dark: light text
• Subdued elements: Light: medium gray, Dark: dark gray
• Interactive elements: Green/yellow filter prompts, purple accents

Accessibility

• All color combinations meet WCAG contrast requirements
• Colors are distinguishable for common color vision differences
• Text remains readable in both light and dark terminal themes

Visual Design

The default layout follows these principles:

• Padding: Consistent 2-unit left padding for alignment
• Spacing: 1-line spacing for readability
• Borders: Minimal, used only for emphasis
• Typography: No decorative fonts, clear hierarchy

Examples

use bubbletea_widgets::list::style::ListStyles;

// Get default styles
let styles = ListStyles::default();

// The styles will automatically adapt to your terminal theme
// In light terminals: dark text on light backgrounds
// In dark terminals: light text on dark backgrounds

Compatibility

These defaults are designed to match the visual appearance of the original Go charmbracelet/bubbles library, ensuring consistency across different implementations.