Struct IFrameManager 

pub struct IFrameManager { /* private fields */ }

Manages IFrame lifecycle, including re-invocation and PipelineId generation

Tracks which IFrames have been invoked, assigns unique DOM IDs to nested IFrames, and determines when IFrames need to be re-invoked (e.g., when the container bounds expand or the user scrolls near an edge).

Implementations

impl IFrameManager

pub fn new() -> Self

Creates a new IFrameManager with no tracked IFrames

pub fn begin_frame(&mut self)

Called at the start of each frame (currently a no-op)

pub fn get_or_create_nested_dom_id( &mut self, dom_id: DomId, node_id: NodeId, ) -> DomId

Gets or creates a unique nested DOM ID for an IFrame

Returns the existing DOM ID if the IFrame was previously registered, otherwise allocates a new unique ID and initializes the IFrame state.

pub fn get_nested_dom_id(&self, dom_id: DomId, node_id: NodeId) -> Option<DomId>

Gets the nested DOM ID for an IFrame if it exists

pub fn get_or_create_pipeline_id( &mut self, dom_id: DomId, node_id: NodeId, ) -> PipelineId

Gets or creates a WebRender PipelineId for an IFrame

PipelineIds are used by WebRender to identify distinct rendering contexts.

pub fn was_iframe_invoked(&self, dom_id: DomId, node_id: NodeId) -> bool

Returns whether the IFrame has ever been invoked

pub fn update_iframe_info( &mut self, dom_id: DomId, node_id: NodeId, scroll_size: LogicalSize, virtual_scroll_size: LogicalSize, ) -> Option<()>

Updates the IFrame’s content size information

Called after the IFrame callback returns to record the actual content dimensions. If the new size is larger than previously recorded, clears the expansion flag to allow BoundsExpanded re-invocation.

pub fn mark_invoked( &mut self, dom_id: DomId, node_id: NodeId, reason: IFrameCallbackReason, ) -> Option<()>

Marks an IFrame as invoked for a specific reason

Updates internal state flags based on the callback reason to prevent duplicate callbacks for the same trigger condition.

pub fn force_reinvoke(&mut self, dom_id: DomId, node_id: NodeId) -> Option<()>

Force an IFrame to be re-invoked on the next layout pass

Clears all invocation flags, causing check_reinvoke() to return InitialRender. Used by trigger_iframe_rerender() to manually refresh IFrame content.

pub fn check_reinvoke( &mut self, dom_id: DomId, node_id: NodeId, scroll_manager: &ScrollManager, layout_bounds: LogicalRect, ) -> Option<IFrameCallbackReason>

Checks whether an IFrame needs to be re-invoked and returns the reason

Returns Some(reason) if the IFrame callback should be invoked:

• InitialRender: IFrame has never been invoked
• BoundsExpanded: Container grew larger than content
• EdgeScrolled: User scrolled near an edge (for lazy loading)

Returns None if no re-invocation is needed.

Trait Implementations

impl Clone for IFrameManager

fn clone(&self) -> IFrameManager

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for IFrameManager

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

Formats the value using the given formatter.

impl Default for IFrameManager

fn default() -> IFrameManager

Returns the “default value” for a type.