Enum DisplayListItem 

pub enum DisplayListItem {
    Rect {
        bounds: LogicalRect,
        color: ColorU,
        border_radius: BorderRadius,
    },
    SelectionRect {
        bounds: LogicalRect,
        border_radius: BorderRadius,
        color: ColorU,
    },
    CursorRect {
        bounds: LogicalRect,
        color: ColorU,
    },
    Border {
        bounds: LogicalRect,
        widths: StyleBorderWidths,
        colors: StyleBorderColors,
        styles: StyleBorderStyles,
        border_radius: StyleBorderRadius,
    },
    TextLayout {
        layout: Arc<dyn Any + Send + Sync>,
        bounds: LogicalRect,
        font_hash: FontHash,
        font_size_px: f32,
        color: ColorU,
    },
    Text {
        glyphs: Vec<GlyphInstance>,
        font_hash: FontHash,
        font_size_px: f32,
        color: ColorU,
        clip_rect: LogicalRect,
    },
    Underline {
        bounds: LogicalRect,
        color: ColorU,
        thickness: f32,
    },
    Strikethrough {
        bounds: LogicalRect,
        color: ColorU,
        thickness: f32,
    },
    Overline {
        bounds: LogicalRect,
        color: ColorU,
        thickness: f32,
    },
    Image {
        bounds: LogicalRect,
        image: ImageRef,
    },
    ScrollBar {
        bounds: LogicalRect,
        color: ColorU,
        orientation: ScrollbarOrientation,
        opacity_key: Option<OpacityKey>,
        hit_id: Option<ScrollbarHitId>,
    },
    ScrollBarStyled {
        info: Box<ScrollbarDrawInfo>,
    },
    IFrame {
        child_dom_id: DomId,
        bounds: LogicalRect,
        clip_rect: LogicalRect,
    },
    PushClip {
        bounds: LogicalRect,
        border_radius: BorderRadius,
    },
    PopClip,
    PushScrollFrame {
        clip_bounds: LogicalRect,
        content_size: LogicalSize,
        scroll_id: LocalScrollId,
    },
    PopScrollFrame,
    PushStackingContext {
        z_index: i32,
        bounds: LogicalRect,
    },
    PopStackingContext,
    HitTestArea {
        bounds: LogicalRect,
        tag: DisplayListTagId,
    },
    LinearGradient {
        bounds: LogicalRect,
        gradient: LinearGradient,
        border_radius: BorderRadius,
    },
    RadialGradient {
        bounds: LogicalRect,
        gradient: RadialGradient,
        border_radius: BorderRadius,
    },
    ConicGradient {
        bounds: LogicalRect,
        gradient: ConicGradient,
        border_radius: BorderRadius,
    },
    BoxShadow {
        bounds: LogicalRect,
        shadow: StyleBoxShadow,
        border_radius: BorderRadius,
    },
    PushFilter {
        bounds: LogicalRect,
        filters: Vec<StyleFilter>,
    },
    PopFilter,
    PushBackdropFilter {
        bounds: LogicalRect,
        filters: Vec<StyleFilter>,
    },
    PopBackdropFilter,
    PushOpacity {
        bounds: LogicalRect,
        opacity: f32,
    },
    PopOpacity,
}

A command in the display list. Can be either a drawing primitive or a state-management instruction for the renderer’s graphics context.

Variants

Rect

A filled rectangle with optional rounded corners. Used for backgrounds, colored boxes, and other solid fills.

Fields

bounds: LogicalRect

The rectangle bounds in logical coordinates

color: ColorU

The fill color (RGBA)

border_radius: BorderRadius

Corner radii for rounded rectangles

SelectionRect

A selection highlight rectangle (e.g., for text selection). Rendered behind text to show selected regions.

Fields

bounds: LogicalRect

The rectangle bounds in logical coordinates

border_radius: BorderRadius

Corner radii for rounded selection

color: ColorU

The selection highlight color (typically semi-transparent)

CursorRect

A text cursor (caret) rectangle. Typically a thin vertical line indicating text insertion point.

Fields

bounds: LogicalRect

The cursor bounds (usually narrow width)

color: ColorU

The cursor color

Border

A CSS border with per-side widths, colors, and styles. Supports different styles per side (solid, dashed, dotted, etc.).

Fields

bounds: LogicalRect

The border-box bounds

widths: StyleBorderWidths

Border widths for each side

colors: StyleBorderColors

Border colors for each side

styles: StyleBorderStyles

Border styles for each side (solid, dashed, etc.)

border_radius: StyleBorderRadius

Corner radii for rounded borders

TextLayout

Text layout with full metadata (for PDF, accessibility, etc.) This is pushed BEFORE the individual Text items and contains the original text, glyph-to-unicode mapping, and positioning info

Fields

layout: Arc<dyn Any + Send + Sync>

bounds: LogicalRect

font_hash: FontHash

font_size_px: f32

color: ColorU

Text

Text rendered with individual glyph positioning (for simple renderers)

Fields

glyphs: Vec<GlyphInstance>

font_hash: FontHash

font_size_px: f32

color: ColorU

clip_rect: LogicalRect

Underline

Underline decoration for text (CSS text-decoration: underline)

Fields

bounds: LogicalRect

color: ColorU

thickness: f32

Strikethrough

Strikethrough decoration for text (CSS text-decoration: line-through)

Fields

bounds: LogicalRect

color: ColorU

thickness: f32

Overline

Overline decoration for text (CSS text-decoration: overline)

Fields

bounds: LogicalRect

color: ColorU

thickness: f32

Image

Fields

bounds: LogicalRect

image: ImageRef

ScrollBar

A dedicated primitive for a scrollbar with optional GPU-animated opacity. This is a simple single-color scrollbar used for basic rendering.

Fields

bounds: LogicalRect

color: ColorU

orientation: ScrollbarOrientation

opacity_key: Option<OpacityKey>

Optional opacity key for GPU-side fading animation. If present, the renderer will use this key to look up dynamic opacity. If None, the alpha channel of color is used directly.

hit_id: Option<ScrollbarHitId>

Optional hit-test ID for WebRender hit-testing. If present, allows event handlers to identify which scrollbar component was clicked.

ScrollBarStyled

A fully styled scrollbar with separate track, thumb, and optional buttons. Used when CSS scrollbar properties are specified.

Fields

info: Box<ScrollbarDrawInfo>

Complete drawing information for all scrollbar components

IFrame

An embedded IFrame that references a child DOM with its own display list. This mirrors webrender’s IframeDisplayItem. The renderer will look up the child display list by child_dom_id and render it within the bounds.

Fields

child_dom_id: DomId

The DomId of the child DOM (similar to webrender’s pipeline_id)

bounds: LogicalRect

The bounds where the IFrame should be rendered

clip_rect: LogicalRect

The clip rect for the IFrame content

PushClip

Pushes a new clipping rectangle onto the renderer’s clip stack. All subsequent primitives will be clipped by this rect until a PopClip.

Fields

bounds: LogicalRect

border_radius: BorderRadius

PopClip

Pops the current clip from the renderer’s clip stack.

PushScrollFrame

Defines a scrollable area. This is a specialized clip that also establishes a new coordinate system for its children, which can be offset.

Fields

clip_bounds: LogicalRect

The clip rect in the parent’s coordinate space.

content_size: LogicalSize

The total size of the scrollable content.

scroll_id: LocalScrollId

An ID for the renderer to track this scrollable area between frames.

PopScrollFrame

Pops the current scroll frame.

PushStackingContext

Pushes a new stacking context for proper z-index layering. All subsequent primitives until PopStackingContext will be in this stacking context.

Fields

z_index: i32

The z-index for this stacking context (for debugging/validation)

bounds: LogicalRect

The bounds of the stacking context root element

PopStackingContext

Pops the current stacking context.

HitTestArea

Defines a region for hit-testing.

Fields

bounds: LogicalRect

tag: DisplayListTagId

LinearGradient

A linear gradient fill.

Fields

bounds: LogicalRect

gradient: LinearGradient

border_radius: BorderRadius

RadialGradient

A radial gradient fill.

Fields

bounds: LogicalRect

gradient: RadialGradient

border_radius: BorderRadius

ConicGradient

A conic (angular) gradient fill.

Fields

bounds: LogicalRect

gradient: ConicGradient

border_radius: BorderRadius

BoxShadow

A box shadow (either outset or inset).

Fields

bounds: LogicalRect

shadow: StyleBoxShadow

border_radius: BorderRadius

PushFilter

Push a filter effect that applies to subsequent content.

Fields

bounds: LogicalRect

filters: Vec<StyleFilter>

PopFilter

Pop a previously pushed filter.

PushBackdropFilter

Push a backdrop filter (applies to content behind the element).

Fields

bounds: LogicalRect

filters: Vec<StyleFilter>

PopBackdropFilter

Pop a previously pushed backdrop filter.

PushOpacity

Push an opacity layer.

Fields

bounds: LogicalRect

opacity: f32

PopOpacity

Pop an opacity layer.

Trait Implementations

impl Clone for DisplayListItem

fn clone(&self) -> DisplayListItem

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for DisplayListItem

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

Formats the value using the given formatter.