Struct DisplayList 

pub struct DisplayList {
    pub items: Vec<DisplayListItem>,
    pub node_mapping: Vec<Option<NodeId>>,
    pub forced_page_breaks: Vec<f32>,
    pub fixed_position_item_ranges: Vec<(usize, usize)>,
}

The final, renderer-agnostic output of the layout engine.

This is a flat list of drawing and state-management commands, already sorted according to the CSS paint order. A renderer can consume this list directly.

Fields

items: Vec<DisplayListItem>

node_mapping: Vec<Option<NodeId>>

Optional mapping from item index to the DOM NodeId that generated it. Used for pagination to look up CSS break properties. Not all items have a source node (e.g., synthesized decorations).

forced_page_breaks: Vec<f32>

Y-positions where forced page breaks should occur (from break-before/break-after: always). These are absolute Y coordinates in the infinite canvas coordinate system. The slicer will ensure page boundaries align with these positions.

fixed_position_item_ranges: Vec<(usize, usize)>

Index ranges (start, end) of display list items that belong to fixed-position elements. In paged media, these items are replicated on every page (CSS Positioned Layout §2.1).

Implementations

impl DisplayList

pub fn patch_text_glyphs( &mut self, node_index: usize, new_glyphs_by_run: &[Vec<GlyphInstance>], ) -> Option<LogicalRect>

Patch text glyph data for a specific layout node without rebuilding the entire display list. Returns the damage rect covering all affected text items, or None if no matching items found.

Used for GlyphSwap incremental relayout: glyphs changed but positions are identical, so only the glyph IDs need updating.

pub fn compute_text_damage_rect( old_items: &[PositionedItem], new_items: &[PositionedItem], container_origin: LogicalPosition, affected_line: usize, ) -> LogicalRect

Compute a damage rect from the difference between old and new text layout results, starting from a given line index.

pub fn to_debug_json(&self) -> String

Generates a JSON representation of the display list for debugging. This includes clip chain analysis showing how clips are stacked.

Trait Implementations

impl Clone for DisplayList

fn clone(&self) -> DisplayList

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for DisplayList

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

Formats the value using the given formatter.

impl Default for DisplayList

fn default() -> DisplayList

Returns the “default value” for a type.