Struct GlyphSet 

pub struct GlyphSet {
    pub track_vertical: char,
    pub track_horizontal: char,
    pub arrow_vertical_start: char,
    pub arrow_vertical_end: char,
    pub arrow_horizontal_start: char,
    pub arrow_horizontal_end: char,
    pub thumb_vertical_lower: [char; 8],
    pub thumb_vertical_upper: [char; 8],
    pub thumb_horizontal_left: [char; 8],
    pub thumb_horizontal_right: [char; 8],
}

Glyphs used to render the track, arrows, and thumb.

Arrays use indices 0..=7 to represent 1/8th through full coverage.

Fields

track_vertical: char

Track glyph for vertical scrollbars.

track_horizontal: char

Track glyph for horizontal scrollbars.

arrow_vertical_start: char

Arrow glyph for the start of a vertical scrollbar (top).

arrow_vertical_end: char

Arrow glyph for the end of a vertical scrollbar (bottom).

arrow_horizontal_start: char

Arrow glyph for the start of a horizontal scrollbar (left).

arrow_horizontal_end: char

Arrow glyph for the end of a horizontal scrollbar (right).

thumb_vertical_lower: [char; 8]

Thumb glyphs for vertical lower fills (1/8th through full).

thumb_vertical_upper: [char; 8]

Thumb glyphs for vertical upper fills (1/8th through full).

thumb_horizontal_left: [char; 8]

Thumb glyphs for horizontal left fills (1/8th through full).

thumb_horizontal_right: [char; 8]

Thumb glyphs for horizontal right fills (1/8th through full).

Implementations

impl GlyphSet

pub const fn minimal() -> Self

Minimal glyphs: no visible track by default.

Choose this when the thumb should stand out by color against a filled background instead of a visible line.

This uses a space character for the track so the scrollbar is “all thumb”, with the background color coming from track_style.

[██      ]
[🮋█▏     ]
[🮊█▎     ]
[🮉█▍     ]
[▐█▌     ]
[🮈█▋     ]
[🮇█▊     ]
[▕█▉     ]
[ ██     ]

pub const fn box_drawing() -> Self

Glyphs that include box-drawing line symbols for the track.

Choose this when callers should see a visible track line behind the thumb.

[██──────]
[🮋█▏─────]
[🮊█▎─────]
[🮉█▍─────]
[▐█▌─────]
[🮈█▋─────]
[🮇█▊─────]
[▕█▉─────]
[─██─────]

Examples found in repository

examples/scrollbar_styled.rs (line 61)

fn render(area: Rect, frame: &mut ratatui::Frame) {
    if area.width < 2 || area.height < 2 {
        return;
    }

    let horizontal_bar = area
        .rows()
        .next_back()
        .unwrap_or(area)
        .inner(Margin::new(1, 0));
    let vertical_bar = area
        .columns()
        .next_back()
        .unwrap_or(area)
        .inner(Margin::new(0, 1));

    let block = Block::new()
        .borders(Borders::ALL)
        .title("styled scrollbars")
        .border_style((Color::LightBlue, Color::Black))
        .style((Color::Gray, Color::Black));
    let content = block.inner(area).inner(Margin::new(2, 1));
    frame.render_widget(block, area);

    frame.render_widget(
        Paragraph::new("track_style, thumb_style, and arrow_style can each use distinct colors")
            .style((Color::Gray, Color::Black)),
        content,
    );

    let lengths = ScrollLengths {
        content_len: 160,
        viewport_len: 40,
    };
    let horizontal = ScrollBar::horizontal(lengths)
        .offset(48)
        .arrows(ScrollBarArrows::Both)
        .glyph_set(GlyphSet::box_drawing())
        .track_style((Color::Blue, Color::Black).into())
        .thumb_style((Color::Yellow, Modifier::BOLD).into())
        .arrow_style((Color::LightGreen, Color::Black, Modifier::BOLD).into());
    let vertical = ScrollBar::vertical(lengths)
        .offset(80)
        .arrows(ScrollBarArrows::Both)
        .glyph_set(GlyphSet::box_drawing())
        .track_style((Color::Magenta, Color::Black).into())
        .thumb_style((Color::Cyan, Modifier::BOLD).into())
        .arrow_style((Color::LightRed, Color::Black, Modifier::BOLD).into());

    frame.render_widget(&horizontal, horizontal_bar);
    frame.render_widget(&vertical, vertical_bar);
}

pub const fn symbols_for_legacy_computing() -> Self

Glyphs that mix standard block elements with legacy supplement glyphs.

Choose this when the terminal font supports Symbols for Legacy Computing and you want precise 1/8th-cell rendering on every thumb edge.

Use this to get full 1/8th coverage for upper and right edges that the standard block set lacks; these glyphs come from Symbols for Legacy Computing.

[██──────]
[🮋█▏─────]
[🮊█▎─────]
[🮉█▍─────]
[▐█▌─────]
[🮈█▋─────]
[🮇█▊─────]
[▕█▉─────]
[─██─────]

pub const fn unicode() -> Self

Glyphs using only standard Unicode block elements.

Choose this if your font lacks the legacy glyphs.

The standard block set does not include 1/8th upper or right fills (those come from Symbols for Legacy Computing), so this set approximates upper and right partials by rounding to coarse blocks:

• ~1/4: ▔ / ▕
• ~1/2 and ~3/4: ▀ / ▐
• ~7/8 and full: █

[██──────]
[██▏─────]
[▐█▎─────]
[▐█▍─────]
[▐█▌─────]
[▐█▋─────]
[▕█▊─────]
[▕█▉─────]
[─██─────]

Trait Implementations

impl Clone for GlyphSet

fn clone(&self) -> GlyphSet

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for GlyphSet

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

Formats the value using the given formatter.

impl Default for GlyphSet

fn default() -> Self

Returns the “default value” for a type.

impl Eq for GlyphSet

impl PartialEq for GlyphSet

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

Tests for self and other values to be equal, and is used by ==.

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

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl StructuralPartialEq for GlyphSet