Struct DefaultDelegate

pub struct DefaultDelegate {
    pub show_description: bool,
    pub styles: DefaultItemStyles,
    /* private fields */
}

A delegate for rendering DefaultItem instances in list components.

This delegate provides the standard rendering logic for DefaultItem objects, handling different visual states, filtering highlights, and layout options. It implements the ItemDelegate trait to integrate seamlessly with the list component system.

Features

• Adaptive styling: Automatically adjusts colors for light/dark terminals
• State rendering: Handles normal, selected, and dimmed visual states
• Filter highlighting: Character-level highlighting of search matches
• Flexible layout: Configurable description display and item spacing
• Responsive design: Adjusts rendering based on available width

Configuration

The delegate can be customized through its public fields:

• show_description: Controls whether descriptions are rendered below titles
• styles: Complete styling configuration for all visual states

Usage with List

The delegate is designed to work with the Model<DefaultItem> list component and handles all the rendering complexity automatically.

Examples

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

// Create a delegate with default settings
let delegate = DefaultDelegate::new();

// Customize the delegate
let mut custom_delegate = DefaultDelegate::new();
custom_delegate.show_description = false; // Hide descriptions

// Use with a list
let items = vec![
    DefaultItem::new("Task 1", "First task description"),
    DefaultItem::new("Task 2", "Second task description"),
];
let list = Model::new(items, delegate, 80, 24);

Fields

show_description: bool

Whether to show the description beneath the title.

styles: DefaultItemStyles

Styling used for different visual states.

Implementations

impl DefaultDelegate

pub fn new() -> Self

Creates a new delegate with default styles and layout.

This is equivalent to DefaultDelegate::default() and provides a convenient constructor for creating a new delegate with standard settings.

Returns

A new DefaultDelegate configured with default settings suitable for most list use cases.

Examples

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

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

Trait Implementations

impl Clone for DefaultDelegate

fn clone(&self) -> DefaultDelegate

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for DefaultDelegate

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

Formats the value using the given formatter.

impl Default for DefaultDelegate

fn default() -> Self

Creates a new delegate with default configuration.

The default delegate is configured with:

• Description display enabled
• Standard adaptive styling
• Height of 2 lines (title + description)
• 1 line spacing between items

This configuration provides a standard list appearance that matches the Go bubbles library defaults.

Examples

use bubbletea_widgets::list::DefaultDelegate;

let delegate = DefaultDelegate::default();
assert_eq!(delegate.show_description, true);

impl<I: Item + 'static> ItemDelegate<I> for DefaultDelegate

fn render(&self, m: &Model<I>, index: usize, item: &I) -> String

Renders an item as a styled string for display in the list.

This method handles the complete rendering pipeline for list items, including:

• State detection (normal, selected, dimmed)
• Filter highlighting with character-level precision
• Style application based on current state
• Layout formatting (single-line or with description)

The rendering adapts to the current list state, applying different styles for selected items, dimmed items during filtering, and highlighting characters that match the current filter.

Arguments

• m - The list model containing state information
• index - The index of this item in the list
• item - The item to render

Returns

A formatted string with ANSI styling codes that represents the visual appearance of the item. Returns an empty string if the list width is 0.

Visual States

• Normal: Standard appearance for unselected items
• Selected: Highlighted with left border and accent colors
• Dimmed: Faded appearance when filtering with empty input
• Filtered: Normal or selected appearance with character highlights

fn height(&self) -> usize

Returns the height in lines that each item occupies.

The height depends on whether descriptions are enabled:

• With descriptions: Returns the configured height (default 2 lines)
• Without descriptions: Always returns 1 line

This height is used by the list component for layout calculations, viewport sizing, and scroll positioning.

Returns

The number of terminal lines each item will occupy when rendered.

fn spacing(&self) -> usize

Returns the number of blank lines between items.

This spacing is added between each item in the list to improve readability and visual separation. The default spacing is 1 line.

Returns

The number of blank lines to insert between rendered items.

fn update(&self, _msg: &Msg, _m: &mut Model<I>) -> Option<Cmd>

Handles update messages for the delegate.

The default delegate implementation does not require any message handling, so this method always returns None. Override this method in custom delegates that need to respond to keyboard input, timer events, or other application messages.

Arguments

• _msg - The message to handle (unused in default implementation)
• _m - Mutable reference to the list model (unused in default implementation)

Returns

Always returns None as the default delegate requires no update commands.