Struct PaintTimingHandler 

pub(crate) struct PaintTimingHandler {
    viewport_rect: LayoutRect,
    is_document_paintable: bool,
    is_document_contentful: bool,
    previously_reported_paints: PaintTimingReport,
    lcp_next_uuid: u64,
    lcp_candidate: Option<LCPCandidate>,
    reported_image_nodes: HashSet<OpaqueNode>,
    images_pending_rendering: Vec<PendingImageRecord>,
    elements_with_rendered_text: HashSet<OpaqueNode>,
    elements_with_pending_rendered_text: HashMap<OpaqueNode, TextRecord>,
}

Fields

viewport_rect: LayoutRect

The rect of viewport.

is_document_paintable: bool

Whether the current display list contains paintable items.

is_document_contentful: bool

Whether the current display list contains contentful items.

previously_reported_paints: PaintTimingReport

https://www.w3.org/TR/paint-timing/#set-of-previously-reported-paints

lcp_next_uuid: u64

Counter for generating unique LCP candidate UUIDs.

lcp_candidate: Option<LCPCandidate>

The LCP candidate, it may be a image or text.

reported_image_nodes: HashSet<OpaqueNode>

The set of image nodes that have been reported as LCP candidates.

images_pending_rendering: Vec<PendingImageRecord>

https://www.w3.org/TR/paint-timing/#images-pending-rendering

elements_with_rendered_text: HashSet<OpaqueNode>

https://www.w3.org/TR/paint-timing/#set-of-elements-with-rendered-text The set of text nodes that have been reported as LCP candidates.

elements_with_pending_rendered_text: HashMap<OpaqueNode, TextRecord>

The set of pending text nodes that will fight for LCP candidate.

Implementations

impl PaintTimingHandler

pub(crate) fn new(viewport_size: LayoutSize) -> Self

pub(crate) fn mark_document_is_paintable(&mut self)

Marks the current display list as containing a paintable item.

pub(crate) fn mark_document_is_contentful(&mut self)

Marks the current display list as containing a contentful item.

pub(crate) fn append_image_record( &mut self, tag: Option<Tag>, bounds: LayoutRect, clip_rect: LayoutRect, transform: FastLayoutTransform, url: Option<ServoUrl>, natural_width: Option<Au>, natural_height: Option<Au>, )

pub(crate) fn accumulate_text_rect( &mut self, tag: Tag, rect: LayoutRect, transform: FastLayoutTransform, style: &ServoArc<ComputedValues>, )

fn paintable_bounding_rect(&self, bounds: LayoutRect) -> LayoutRect

https://www.w3.org/TR/paint-timing/#paintable-bounding-rect

pub(crate) fn paintable(&self, bounds: LayoutRect, opacity: f32) -> bool

https://www.w3.org/TR/paint-timing/#paintable

pub(crate) fn check_if_paintable(&mut self, bounds: LayoutRect, opacity: f32)

Marks wether the document is having paintable element

https://www.w3.org/TR/paint-timing/#paintable

fn effective_visual_size( &self, intersection_rect: LayoutRect, candidate_type: LCPCandidateType<'_>, ) -> Option<f32>

https://www.w3.org/TR/largest-contentful-paint/#sec-effective-visual-size

fn compute_new_lcp_candidate( &mut self, painted_images: Vec<PendingImageRecord>, painted_text_nodes: HashMap<OpaqueNode, TextRecord>, ) -> Option<LCPCandidate>

https://www.w3.org/TR/largest-contentful-paint/#compute-a-new-largest-contentful-paint-candidate

fn report_largest_contentful_paint( &mut self, halt_lcp: bool, painted_images: Vec<PendingImageRecord>, painted_text_nodes: HashMap<OpaqueNode, TextRecord>, )

https://www.w3.org/TR/largest-contentful-paint/#sec-report-largest-contentful-paint

fn should_report_first_paint(&self) -> bool

https://www.w3.org/TR/paint-timing/#first-paint

fn should_report_first_contentful_paint(&self) -> bool

https://www.w3.org/TR/paint-timing/#first-contentful-paint

pub(crate) fn mark_paint_timing( &mut self, paint_timing_eligible: bool, halt_lcp: bool, ) -> PaintTimingReport

https://www.w3.org/TR/paint-timing/#mark-paint-timing

Note: Step 10 is not in the current version of the specifications. Refer https://github.com/w3c/paint-timing/issues/122 for details on the issue and for the modified steps yet to be merged.

pub(crate) fn largest_contentful_paint_candidate(&self) -> Option<LCPCandidate>