Struct Attrs 

pub struct Attrs<'a> {
    pub font_size: f32,
    /* private fields */
}

Text styling attributes used to configure font properties, color, and layout.

Attrs uses a builder pattern where each setter consumes and returns self, making it easy to chain calls. Unset fields (None) inherit from the layout defaults when applied to a Parley builder.

Defaults

Property	Default
font_size	16.0
line_height	LineHeightValue::Normal(1.0)
color	None (inherits from context)
family	None (system default)
weight	None (normal)
style	None (normal)
font_width	None (normal)
metadata	None

Example

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

let families = [FamilyOwned::Name("Inter".to_string()), FamilyOwned::SansSerif];
let attrs = Attrs::new()
    .family(&families)
    .font_size(14.0)
    .weight(FontWeight::BOLD)
    .color(Color::WHITE)
    .line_height(LineHeightValue::Normal(1.4));

Fields

font_size: f32

Font size in pixels.

Implementations

impl<'a> Attrs<'a>

pub fn new() -> Self

Creates a new Attrs with default values (16px font, 1.0 line height multiplier).

pub fn color(self, color: Color) -> Self

Sets the text color.

pub fn family(self, family: &'a [FamilyOwned]) -> Self

Sets the font family list. Families are tried in order as fallbacks.

pub fn font_width(self, stretch: FontWidth) -> Self

Sets the font width (stretch), e.g. condensed or expanded.

pub fn font_style(self, font_style: FontStyle) -> Self

Sets the font style (normal, italic, or oblique).

pub fn weight(self, weight: FontWeight) -> Self

Sets the font weight (e.g. FontWeight::BOLD).

pub fn raw_weight(self, weight: u16) -> Self

Sets the font weight from a raw numeric value (typically 100–900).

pub fn font_size(self, font_size: f32) -> Self

Sets the font size in pixels.

pub fn word_break(self, word_break: WordBreakStrength) -> Self

Sets the word break strength used when text wrapping is enabled.

pub fn line_height(self, line_height: LineHeightValue) -> Self

Sets the line height. See LineHeightValue for the available modes.

pub fn metadata(self, metadata: usize) -> Self

Sets an opaque metadata value that is carried through layout.

This can be used to associate application-specific data (e.g. a span identifier) with a range of text.

pub fn get_color(&self) -> Option<Color>

Returns the text color, or None if unset.

pub fn get_line_height(&self) -> LineHeightValue

Returns the line height setting.

pub fn get_family(&self) -> Option<&'a [FamilyOwned]>

Returns the font family list, or None if unset.

pub fn get_weight(&self) -> Option<FontWeight>

Returns the font weight, or None if unset.

pub fn get_font_style(&self) -> Option<FontStyle>

Returns the font style, or None if unset.

pub fn get_stretch(&self) -> Option<FontWidth>

Returns the font width (stretch), or None if unset.

pub fn get_word_break(&self) -> Option<WordBreakStrength>

Returns the word break strength, or None if unset.

pub fn get_metadata(&self) -> Option<usize>

Returns the metadata value, or None if unset.

pub fn effective_line_height(&self) -> f32

Computes the effective line height in pixels.

For LineHeightValue::Normal, this multiplies the font size by the factor. For LineHeightValue::Pt, the point value is returned directly.

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

Pushes all set properties as defaults onto a Parley RangedBuilder.

Font size and line height are always pushed. Optional properties (color, family, weight, style, width) are only pushed when set.

pub fn apply_range( &self, builder: &mut RangedBuilder<'_, TextBrush>, range: Range<usize>, defaults: &Attrs<'_>, )

Pushes style properties for a specific byte range onto a Parley RangedBuilder.

Only properties that differ from defaults are pushed, avoiding redundant work when a span shares most attributes with the base style.

Trait Implementations

impl<'a> Clone for Attrs<'a>

fn clone(&self) -> Attrs<'a>

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<'a> Debug for Attrs<'a>

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

Formats the value using the given formatter.

impl Default for Attrs<'_>

fn default() -> Self

Returns the “default value” for a type.