Struct HTMLIFrameElement 

#[repr(C)]
pub(crate) struct HTMLIFrameElement {
    htmlelement: HTMLElement,
    webview_id: Cell<Option<WebViewId>>,
    browsing_context_id: Cell<Option<BrowsingContextId>>,
    pipeline_id: Cell<Option<PipelineId>>,
    pending_pipeline_id: Cell<Option<PipelineId>>,
    about_blank_pipeline_id: Cell<Option<PipelineId>>,
    sandbox: MutNullableDom<DOMTokenList>,
    sandboxing_flag_set: Cell<Option<SandboxingFlagSet>>,
    load_blocker: DomRefCell<Option<LoadBlocker>>,
    throttled: Cell<bool>,
    script_window_proxies: Rc<ScriptWindowProxies>,
    pending_navigation: Cell<bool>,
}

Fields

htmlelement: HTMLElement

webview_id: Cell<Option<WebViewId>>

browsing_context_id: Cell<Option<BrowsingContextId>>

pipeline_id: Cell<Option<PipelineId>>

pending_pipeline_id: Cell<Option<PipelineId>>

about_blank_pipeline_id: Cell<Option<PipelineId>>

sandbox: MutNullableDom<DOMTokenList>

sandboxing_flag_set: Cell<Option<SandboxingFlagSet>>

load_blocker: DomRefCell<Option<LoadBlocker>>

throttled: Cell<bool>

script_window_proxies: Rc<ScriptWindowProxies>

pending_navigation: Cell<bool>

Keeping track of whether the iframe will be navigated outside of the processing of it’s attribute(for example: form navigation). This is necessary to prevent the iframe load event steps from asynchronously running for the initial blank document while script at this point(when the flag is set) expects those to run only for the navigated documented.

Implementations

impl HTMLIFrameElement

fn __assert_parent_type(&self)

impl HTMLIFrameElement

fn get_url(&self) -> ServoUrl

https://html.spec.whatwg.org/multipage/#otherwise-steps-for-iframe-or-frame-elements, step 1.

pub(crate) fn navigate_or_reload_child_browsing_context( &self, load_data: LoadData, history_handling: NavigationHistoryBehavior, can_gc: CanGc, )

fn start_new_pipeline( &self, load_data: LoadData, pipeline_type: PipelineType, history_handling: NavigationHistoryBehavior, can_gc: CanGc, )

pub(crate) fn is_initial_blank_document(&self) -> bool

When an iframe is first inserted into the document, an “about:blank” document is created, and synchronously processed by the script thread. This initial synchronous load should have no noticeable effect in script. See the note in iframe_load_event_steps.

fn process_the_iframe_attributes(&self, mode: ProcessingMode, can_gc: CanGc)

https://html.spec.whatwg.org/multipage/#process-the-iframe-attributes

fn create_nested_browsing_context(&self, can_gc: CanGc)

https://html.spec.whatwg.org/multipage/#create-a-new-child-navigable Synchronously create a new browsing context(This is not a navigation). The pipeline started here should remain unnoticeable to script, but this is not easy to refactor because it appears other features have come to rely on the current behavior. For now only the iframe load event steps are skipped in some cases for this initial document, and we still fire load and pageshow events as part of maybe_queue_document_completion. Also, some controversy spec-wise remains: https://github.com/whatwg/html/issues/4965

fn destroy_nested_browsing_context(&self)

pub(crate) fn update_pipeline_id( &self, new_pipeline_id: PipelineId, reason: UpdatePipelineIdReason, can_gc: CanGc, )

fn new_inherited( local_name: LocalName, prefix: Option<Prefix>, document: &Document, ) -> HTMLIFrameElement

pub(crate) fn new( local_name: LocalName, prefix: Option<Prefix>, document: &Document, proto: Option<HandleObject<'_>>, can_gc: CanGc, ) -> DomRoot<HTMLIFrameElement>

pub(crate) fn pipeline_id(&self) -> Option<PipelineId>

pub(crate) fn browsing_context_id(&self) -> Option<BrowsingContextId>

pub(crate) fn webview_id(&self) -> Option<WebViewId>

pub(crate) fn sandboxing_flag_set(&self) -> SandboxingFlagSet

pub(crate) fn set_throttled(&self, throttled: bool)

pub(crate) fn note_pending_navigation(&self)

Note a pending navigation. This is used to ignore the async load event steps for the initial blank document if those haven’t run yet.

pub(crate) fn iframe_load_event_steps( &self, loaded_pipeline: PipelineId, can_gc: CanGc, )

https://html.spec.whatwg.org/multipage/#iframe-load-event-steps

fn parse_sandbox_attribute(&self)

Parse the sandbox attribute value given the Attr. This sets the sandboxing_flag_set property or clears it is the value isn’t specified. Notably, an unspecified sandboxing attribute (no sandboxing) is different from an empty one (full sandboxing).

Trait Implementations

impl Castable for HTMLIFrameElement

fn is<T>(&self) -> bool

where T: DerivedFrom<Self>,

Check whether a DOM object implements one of its deriving interfaces.

fn upcast<T>(&self) -> &T

where T: Castable, Self: DerivedFrom<T>,

Cast a DOM object upwards to one of the interfaces it derives from.

fn downcast<T>(&self) -> Option<&T>

where T: DerivedFrom<Self>,

Cast a DOM object downwards to one of the interfaces it might implement.

impl DomObject for HTMLIFrameElement

fn reflector(&self) -> &Reflector

Returns the receiver’s reflector.

impl DomObjectWrap<DomTypeHolder> for HTMLIFrameElement

const WRAP: unsafe fn(SafeJSContext, &GlobalScope, Option<HandleObject<'_>>, Box<Self>, CanGc) -> Root<Dom<Self>> = {script_bindings::codegen::GenericBindings::HTMLIFrameElementBinding::Wrap::<dom::bindings::codegen::DomTypeHolder::DomTypeHolder> as for<'a, 'b> unsafe fn(script_bindings::script_runtime::JSContext, &'a dom::globalscope::GlobalScope, std::option::Option<js::rust::Handle<'b, *mut js::jsapi::JSObject>>, std::boxed::Box<dom::html::htmliframeelement::HTMLIFrameElement>, script_bindings::script_runtime::CanGc) -> script_bindings::root::Root<script_bindings::root::Dom<dom::html::htmliframeelement::HTMLIFrameElement>>}

Function pointer to the general wrap function type

impl HTMLIFrameElementMethods<DomTypeHolder> for HTMLIFrameElement

fn Srcdoc(&self) -> TrustedHTMLOrString<DomTypeHolder>

https://html.spec.whatwg.org/multipage/#dom-iframe-srcdoc

fn SetSrcdoc( &self, value: TrustedHTMLOrString<DomTypeHolder>, can_gc: CanGc, ) -> Fallible<()>

https://html.spec.whatwg.org/multipage/#dom-iframe-srcdoc

fn Sandbox(&self, can_gc: CanGc) -> DomRoot<DOMTokenList>

https://html.spec.whatwg.org/multipage/#dom-iframe-sandbox

The supported tokens for sandbox’s DOMTokenList are the allowed values defined in the sandbox attribute and supported by the user agent. These range of possible values is defined here: https://html.spec.whatwg.org/multipage/#attr-iframe-sandbox

fn GetContentWindow(&self) -> Option<DomRoot<WindowProxy>>

https://html.spec.whatwg.org/multipage/#dom-iframe-contentwindow

fn GetContentDocument(&self) -> Option<DomRoot<Document>>

https://html.spec.whatwg.org/multipage/#concept-bcc-content-document

fn ReferrerPolicy(&self) -> DOMString

https://html.spec.whatwg.org/multipage/#attr-iframe-referrerpolicy

fn Src(&self) -> USVString

fn SetSrc(&self, value: USVString)

fn SetReferrerPolicy(&self, value: DOMString)

fn AllowFullscreen(&self) -> bool

fn SetAllowFullscreen(&self, value: bool)

fn Width(&self) -> DOMString

fn SetWidth(&self, value: DOMString)

fn Height(&self) -> DOMString

fn SetHeight(&self, value: DOMString)

fn FrameBorder(&self) -> DOMString

fn SetFrameBorder(&self, value: DOMString)

fn SetName(&self, value: DOMString)

fn Name(&self) -> DOMString

impl HasParent for HTMLIFrameElement

fn as_parent(&self) -> &HTMLElement

This is used in a type assertion to ensure that the source and webidls agree as to what the parent type is

type Parent = HTMLElement

impl IDLInterface for HTMLIFrameElement

fn derives(class: &'static DOMClass) -> bool

Returns whether the given DOM class derives that interface.

impl MallocSizeOf for HTMLIFrameElement

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.

impl MutDomObject for HTMLIFrameElement

unsafe fn init_reflector(&self, obj: *mut JSObject)

Initializes the Reflector

impl PartialEq for HTMLIFrameElement

fn eq(&self, other: &Self) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl ToJSValConvertible for HTMLIFrameElement

unsafe fn to_jsval(&self, cx: *mut JSContext, rval: MutableHandleValue<'_>)

Convert self to a JSVal. JSAPI failure causes a panic.

impl Traceable for HTMLIFrameElement

unsafe fn trace(&self, tracer: *mut JSTracer)

Trace self.

impl VirtualMethods for HTMLIFrameElement

fn post_connection_steps(&self, can_gc: CanGc)

https://html.spec.whatwg.org/multipage/#the-iframe-element:html-element-post-connection-steps

fn super_type(&self) -> Option<&dyn VirtualMethods>

Returns self as the superclass of the implementation for this trait, if any.

fn attribute_mutated( &self, attr: &Attr, mutation: AttributeMutation<'_>, can_gc: CanGc, )

Called when attributes of a node are mutated. https://dom.spec.whatwg.org/#attribute-is-set https://dom.spec.whatwg.org/#attribute-is-removed

fn attribute_affects_presentational_hints(&self, attr: &Attr) -> bool

Returns true if given attribute attr affects style of the given element.

fn parse_plain_attribute(&self, name: &LocalName, value: DOMString) -> AttrValue

Returns the right AttrValue variant for the attribute with name name on this element.

fn bind_to_tree(&self, context: &BindContext<'_>, can_gc: CanGc)

Called when a Node is appended to a tree.

fn unbind_from_tree(&self, context: &UnbindContext<'_>, can_gc: CanGc)

Called when a Node is removed from a tree. Implements removing steps: https://dom.spec.whatwg.org/#concept-node-remove-ext

fn children_changed(&self, mutation: &ChildrenMutation<'_>, can_gc: CanGc)

Called on the parent when its children are changed.

fn handle_event(&self, event: &Event, can_gc: CanGc)

Called during event dispatch after the bubbling phase completes.

fn adopting_steps(&self, old_doc: &Document, can_gc: CanGc)

https://dom.spec.whatwg.org/#concept-node-adopt-ext

fn cloning_steps( &self, copy: &Node, maybe_doc: Option<&Document>, clone_children: CloneChildrenFlag, can_gc: CanGc, )

https://dom.spec.whatwg.org/#concept-node-clone-ext

fn pop(&self)

Called on an element when it is popped off the stack of open elements of a parser.

impl DerivedFrom<Element> for HTMLIFrameElement

impl DerivedFrom<EventTarget> for HTMLIFrameElement

impl DerivedFrom<HTMLElement> for HTMLIFrameElement

impl DerivedFrom<Node> for HTMLIFrameElement

impl Eq for HTMLIFrameElement