Struct TextRun

pub(crate) struct TextRun {
    pub base_fragment_info: BaseFragmentInfo,
    pub inline_styles: SharedInlineStyles,
    pub text_range: Range<usize>,
    pub shaped_text: Vec<TextRunSegment>,
    pub selection_range: Option<Range<ByteIndex>>,
}

A single TextRun for the box tree. These are all descendants of super::InlineBox or the root of the super::InlineFormattingContext. During box tree construction, text is split into TextRuns based on their font, script, etc. When these are created text is already shaped.

https://www.w3.org/TR/css-display-3/#css-text-run

Fields

base_fragment_info: BaseFragmentInfo

The BaseFragmentInfo for this TextRun. Usually this comes from the original text node in the DOM for the text.

inline_styles: SharedInlineStyles

The crate::SharedStyle from this TextRuns parent element. This is shared so that incremental layout can simply update the parent element and this TextRun will be updated automatically.

text_range: Range<usize>

The range of text in super::InlineFormattingContext::text_content of the super::InlineFormattingContext that owns this TextRun. These are UTF-8 offsets.

shaped_text: Vec<TextRunSegment>

The text of this TextRun with a font selected, broken into unbreakable segments, and shaped.

selection_range: Option<Range<ByteIndex>>

The selection range for the DOM text node that originated this TextRun. This comes directly from the DOM.

Implementations

impl TextRun

pub(crate) fn new( base_fragment_info: BaseFragmentInfo, inline_styles: SharedInlineStyles, text_range: Range<usize>, selection_range: Option<ServoRange<ByteIndex>>, ) -> Self

pub(super) fn segment_and_shape( &mut self, formatting_context_text: &str, font_context: &FontContext, linebreaker: &mut LineBreaker, font_cache: &mut Vec<FontKeyAndMetrics>, bidi_info: &BidiInfo<'_>, rendering_group_id: RenderingGroupId, )

fn segment_text_by_font( &mut self, formatting_context_text: &str, font_context: &FontContext, font_cache: &mut Vec<FontKeyAndMetrics>, bidi_info: &BidiInfo<'_>, parent_style: &Arc<ComputedValues>, rendering_group_id: RenderingGroupId, ) -> Vec<(TextRunSegment, FontRef)>

Take the TextRun’s text and turn it into TextRunSegments. Each segment has a matched font and script. Fonts may differ when glyphs are found in fallback fonts. Fonts are stored in the font_cache which is a cache of all font keys and metrics used in this super::InlineFormattingContext.

pub(super) fn layout_into_line_items( &self, ifc: &mut InlineFormattingContextLayout<'_>, )

Trait Implementations

impl Debug for TextRun

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

Formats the value using the given formatter.

impl MallocSizeOf for TextRun

fn size_of(&self, ops: &mut MallocSizeOfOps) -> usize

Measure the heap usage of all descendant heap-allocated structures, but not the space taken up by the value itself.