Enum TruncateStrategy 

pub enum TruncateStrategy {
    Middle {
        min_head_items: usize,
        min_tail_items: usize,
        ellipsis: String,
    },
    Start {
        min_tail_items: usize,
        ellipsis: String,
    },
    End {
        min_head_items: usize,
        ellipsis: String,
    },
    ShortenNames {
        max_abbrev_len: usize,
        preserve_tail_items: usize,
        ellipsis: String,
    },
    None,
}

Strategy determining how breadcrumb segments are collapsed when overflowing horizontal bounds.

Variants

Middle

Collapses intermediate ancestor segments into an ellipsis while preserving the root ancestor(s) and deepest active segment(s).

Example: Home ❯ ... ❯ src ❯ sparkline.rs

Fields

min_head_items: usize

Minimum number of root/head segments to preserve on the left.

min_tail_items: usize

Minimum number of leaf/tail segments to preserve on the right.

ellipsis: String

The ellipsis indicator string (default "...").

Start

Collapses leftmost ancestor segments into an ellipsis while preserving the deepest active leaf segments.

Example: ... ❯ src ❯ sparkline.rs

Fields

min_tail_items: usize

Minimum number of leaf/tail segments to preserve on the right.

ellipsis: String

The ellipsis indicator string (default "...").

End

Collapses deepest leaf segments into an ellipsis while preserving root ancestor segments (left-to-right priority).

Example: Home ❯ Projects ❯ ...

Fields

min_head_items: usize

Minimum number of root/head segments to preserve on the left.

ellipsis: String

The ellipsis indicator string (default "...").

ShortenNames

Progressively abbreviates ancestor item labels to their leading characters before collapsing them into an ellipsis if space is still constrained.

Example: H ❯ P ❯ ratatui ❯ src ❯ sparkline.rs

Fields

max_abbrev_len: usize

Target abbreviation character length for shortened ancestor labels (default 1).

preserve_tail_items: usize

Number of deepest tail segments to leave unshortened.

ellipsis: String

Fallback ellipsis indicator if the trail still overflows after shortening.

None

Performs no smart condensation or ellipsis substitution; segments are clipped at the boundary.

Implementations

impl TruncateStrategy

pub fn middle() -> Self

Creates a default Middle strategy preserving 1 root item, 2 tail items, and "..." ellipsis.

pub fn middle_with( min_head_items: usize, min_tail_items: usize, ellipsis: impl Into<String>, ) -> Self

Creates a customized Middle strategy.

pub fn start() -> Self

Creates a default Start strategy preserving 2 tail items and "..." ellipsis.

pub fn start_with(min_tail_items: usize, ellipsis: impl Into<String>) -> Self

Creates a customized Start strategy.

pub fn end() -> Self

Creates a default End strategy preserving 1 head item and "..." ellipsis.

pub fn end_with(min_head_items: usize, ellipsis: impl Into<String>) -> Self

Creates a customized End strategy.

pub fn shorten_names() -> Self

Creates a default ShortenNames strategy abbreviating ancestors to 1 character, preserving 2 tail items, and falling back to "...".

pub fn shorten_names_with( max_abbrev_len: usize, preserve_tail_items: usize, ellipsis: impl Into<String>, ) -> Self

Creates a customized ShortenNames strategy.

pub fn none() -> Self

Creates a None strategy that performs no truncation or ellipsis insertion.

Trait Implementations

impl Clone for TruncateStrategy

fn clone(&self) -> TruncateStrategy

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for TruncateStrategy

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

Formats the value using the given formatter.

impl Default for TruncateStrategy

fn default() -> Self

Defaults to TruncateStrategy::Middle with 1 head item, 2 tail items, and ... ellipsis.

impl Eq for TruncateStrategy

impl PartialEq for TruncateStrategy

fn eq(&self, other: &TruncateStrategy) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl StructuralPartialEq for TruncateStrategy