Struct AttrsList 

pub struct AttrsList { /* private fields */ }

A list of text attributes with default styling and per-range overrides.

AttrsList pairs a set of default Attrs with zero or more byte-range spans that override specific properties. When applied to a Parley builder via apply_to_builder, the defaults are pushed first, then each span is layered on top for its range.

Example

use floem_renderer::text::{Attrs, AttrsList, FontWeight};
use peniko::Color;

let mut attrs_list = AttrsList::new(Attrs::new().font_size(14.0));

// Make bytes 0..5 bold and red.
attrs_list.add_span(
    0..5,
    Attrs::new()
        .font_size(14.0)
        .weight(FontWeight::BOLD)
        .color(Color::WHITE),
);

Implementations

impl AttrsList

pub fn new(defaults: Attrs<'_>) -> Self

Creates a new attribute list with the given default attributes and no spans.

pub fn defaults(&self) -> Attrs<'_>

Returns the default attributes.

pub fn clear_spans(&mut self)

Removes all attribute spans, keeping only the defaults.

pub fn add_span(&mut self, range: Range<usize>, attrs: Attrs<'_>)

Adds an attribute span for the given byte range.

Any existing spans that overlap with range are removed before the new span is inserted.

pub fn get_span(&self, index: usize) -> Attrs<'_>

Returns the attributes at the given byte index.

If a span covers index, its attributes are returned. Otherwise the defaults are returned.

pub fn split_off(&mut self, index: usize) -> Self

Splits this attribute list at the given byte index.

Returns a new AttrsList covering [index..) with span ranges shifted to start from zero. Spans that cross the split point are duplicated into both halves with their ranges adjusted accordingly. self is left containing only the [..index) portion.

pub fn apply_to_builder(&self, builder: &mut RangedBuilder<'_, TextBrush>)

Applies all defaults and spans to a Parley RangedBuilder.

This first pushes the default attributes, then layers each span on top for its byte range. Span properties that match the defaults are skipped to avoid redundant work.

pub fn spans(&self) -> &[(Range<usize>, AttrsOwned)]

Returns the inner spans as a slice of (byte_range, attributes) pairs.

Trait Implementations

impl Clone for AttrsList

fn clone(&self) -> AttrsList

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for AttrsList

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

Formats the value using the given formatter.

impl PartialEq for AttrsList

fn eq(&self, _other: &Self) -> 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.