Struct RichText 

pub struct RichText {
    pub spans: Vec<RichTextSpan>,
    pub max_width: Option<f32>,
    pub timing: TimingConfig,
    pub style: CssStyle,
    pub timeline: Vec<TimelineStep>,
    pub stagger: Option<f32>,
}

Rich text component: renders multiple styled spans on the same line(s).

Fields

spans: Vec<RichTextSpan>

max_width: Option<f32>

timing: TimingConfig

style: CssStyle

timeline: Vec<TimelineStep>

stagger: Option<f32>

Implementations

impl RichText

pub fn compute_layout( spans: &[RichTextSpan], style: &CssStyle, viewport_width: f32, viewport_height: f32, wrap_width: Option<f32>, visible_chars_progress: f32, ) -> RichTextLayout

Word-wrap spans at wrap_width (None = unconstrained/natural width). visible_chars_progress >= 0.0 truncates the content for the typewriter effect (same char-count semantics as text); -1.0 shows everything (used for intrinsic/natural-size measurement, which must not shrink as the typewriter plays out — layout space is reserved for the full content up front).

Unlike the original implementation (which only ever broke a line at a span boundary — a single long span never wrapped internally), this tokenizes every span’s text into words and packs them greedily across span boundaries, so a long single span wraps like any other text. Whitespace runs collapse to a single rendered space (CSS white-space: normal semantics, matching text’s default wrap behaviour); the exact inter-word spacing of source whitespace is not preserved, matching how wrap_text_with_fallback already treats plain text content.

viewport_width/viewport_height resolve rem/vw/vh on style.font-size (lot B, wave S — this used to go through the context-free font_size_px_or, which silently resolved those units to 0px). Callers with no real per-frame viewport (intrinsic measurement, which runs before layout) should pass a stand-in — see intrinsic::measure_time_font_size_ctx’s doc comment for why 0px is worse than an approximation.

Trait Implementations

impl Animatable for RichText

fn animation_effects(&self) -> &[AnimationEffect]

fn timeline_steps(&self) -> &[TimelineStep]

Timed animation steps (timeline field): each step’s animations are resolved with delay += step.at. Empty by default.

impl Debug for RichText

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for RichText

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl JsonSchema for RichText

fn schema_name() -> String

The name of the generated JSON Schema.

fn schema_id() -> Cow<'static, str>

Returns a string that uniquely identifies the schema produced by this type.

fn json_schema(generator: &mut SchemaGenerator) -> Schema

Generates a JSON Schema for this type.

fn is_referenceable() -> bool

Whether JSON Schemas generated for this type should be re-used where possible using the $ref keyword.

impl Painter for RichText

fn paint_content( &self, canvas: &Canvas, layout: &BoxLayout, props: &AnimatedProperties, ctx: &PaintCtx, )

Paint the component’s content into the canvas. The canvas is already translated to the content-box origin and clipped if overflow: hidden was set. Generic decorations (bg, border, shadow) are already painted by the engine.

fn intrinsic_size( &self, _available: AvailableSize, _ctx: &MeasureCtx, ) -> Option<(f32, f32)>

Optional intrinsic measurement for leaves like text, image, codeblock. Return None to let taffy compute the size from the CSS style alone. available mirrors taffy’s AvailableSpace.

impl Serialize for RichText

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl Styled for RichText

fn style_config(&self) -> &CssStyle

impl StyledMut for RichText

fn style_config_mut(&mut self) -> &mut CssStyle

impl Timed for RichText

fn timing(&self) -> (Option<f64>, Option<f64>)