Struct ServoLayoutElement

pub struct ServoLayoutElement<'dom> {
    element: LayoutDom<'dom, Element>,
}

A wrapper around elements that ensures layout can only ever access safe properties.

Fields

element: LayoutDom<'dom, Element>

The wrapped private DOM Element.

Implementations

impl<'dom> ServoLayoutElement<'dom>

pub(super) fn from_layout_js(el: LayoutDom<'dom, Element>) -> Self

pub(super) fn is_html_element(&self) -> bool

fn get_attr_enum( &self, namespace: &Namespace, name: &LocalName, ) -> Option<&AttrValue>

fn get_attr(&self, namespace: &Namespace, name: &LocalName) -> Option<&str>

fn get_style_data(&self) -> Option<&StyleData>

pub unsafe fn unset_snapshot_flags(&self)

Unset the snapshot flags on the underlying DOM object for this element.

Safety

This function accesses and modifies the underlying DOM object and should not be used by more than a single thread at once.

pub unsafe fn set_has_snapshot(&self)

Unset the snapshot flags on the underlying DOM object for this element.

Safety

This function accesses and modifies the underlying DOM object and should not be used by more than a single thread at once.

fn is_body_element_of_html_element_root(&self) -> bool

Returns true if this element is the body child of an html element root element.

fn parent_element(&self) -> Option<Self>

Returns the parent element of this element, if it has one.

fn is_root(&self) -> bool

Trait Implementations

impl<'dom> Clone for ServoLayoutElement<'dom>

fn clone(&self) -> ServoLayoutElement<'dom>

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ServoLayoutElement<'_>

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

Formats the value using the given formatter.

impl<'dom> Element for ServoLayoutElement<'dom>

type Impl = SelectorImpl

fn opaque(&self) -> OpaqueElement

Converts self into an opaque representation.

fn parent_element(&self) -> Option<Self>

fn parent_node_is_shadow_root(&self) -> bool

Whether the parent node of this element is a shadow root.

fn containing_shadow_host(&self) -> Option<Self>

The host of the containing shadow root, if any.

fn is_pseudo_element(&self) -> bool

Whether we’re matching on a pseudo-element.

fn pseudo_element_originating_element(&self) -> Option<Self>

The parent of a given pseudo-element, after matching a pseudo-element selector.

fn prev_sibling_element(&self) -> Option<Self>

Skips non-element nodes

fn next_sibling_element(&self) -> Option<ServoLayoutElement<'dom>>

Skips non-element nodes

fn first_element_child(&self) -> Option<Self>

Skips non-element nodes

fn attr_matches( &self, ns: &NamespaceConstraint<&Namespace>, local_name: &LocalName, operation: &AttrSelectorOperation<&AtomString>, ) -> bool

fn is_root(&self) -> bool

Returns whether this element matches :root, i.e. whether it is the root element of a document.

fn is_empty(&self) -> bool

Returns whether this element matches :empty.

fn has_local_name(&self, name: &LocalName) -> bool

fn has_namespace(&self, ns: &Namespace) -> bool

Empty string for no namespace

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

Whether this element and the other element have the same local name and namespace.

fn match_non_ts_pseudo_class( &self, pseudo_class: &NonTSPseudoClass, _: &mut MatchingContext<'_, Self::Impl>, ) -> bool

fn match_pseudo_element( &self, pseudo: &PseudoElement, _context: &mut MatchingContext<'_, Self::Impl>, ) -> bool

fn is_link(&self) -> bool

Whether this element is a link.

fn has_id(&self, id: &AtomIdent, case_sensitivity: CaseSensitivity) -> bool

fn is_part(&self, name: &AtomIdent) -> bool

fn imported_part(&self, name: &AtomIdent) -> Option<AtomIdent>

Returns the mapping from the exportparts attribute in the reverse direction, that is, in an outer-tree -> inner-tree direction.

fn has_class(&self, name: &AtomIdent, case_sensitivity: CaseSensitivity) -> bool

fn is_html_slot_element(&self) -> bool

Returns whether the element is an HTML element.

fn assigned_slot(&self) -> Option<Self>

Returns the assigned element this element is assigned to.

fn is_html_element_in_html_document(&self) -> bool

fn apply_selector_flags(&self, flags: ElementSelectorFlags)

Sets selector flags on the elemnt itself or the parent, depending on the flags, which indicate what kind of work may need to be performed when DOM state changes.

fn add_element_unique_hashes(&self, filter: &mut BloomFilter) -> bool

Add hashes unique to this element to the given filter, returning true if any got added.

fn has_custom_state(&self, name: &AtomIdent) -> bool

fn has_attr_in_no_namespace( &self, local_name: &<Self::Impl as SelectorImpl>::LocalName, ) -> bool

fn ignores_nth_child_selectors(&self) -> bool

Returns whether this element should ignore matching nth child selector.

impl<'dom> Hash for ServoLayoutElement<'dom>

fn hash<__H: Hasher>(&self, state: &mut __H)

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl<'dom> PartialEq for ServoLayoutElement<'dom>

fn eq(&self, other: &ServoLayoutElement<'dom>) -> 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<'dom> TElement for ServoLayoutElement<'dom>

fn matches_user_and_content_rules(&self) -> bool

Whether this element should match user and content rules. We would like to match rules from the same tree in all cases and optimize computation. UA Widget is an exception since we could have a pseudo element selector inside it.

fn implemented_pseudo_element(&self) -> Option<PseudoElement>

Returns the pseudo-element implemented by this element, if any. In other words, the element will match the specified pseudo element throughout the style computation.

fn has_data(&self) -> bool

Whether there is an ElementData container.

fn borrow_data(&self) -> Option<AtomicRef<'_, ElementData>>

Immutably borrows the ElementData.

fn mutate_data(&self) -> Option<AtomicRefMut<'_, ElementData>>

Mutably borrows the ElementData.

fn shadow_root(&self) -> Option<ServoShadowRoot<'dom>>

The shadow root this element is a host of.

fn containing_shadow(&self) -> Option<ServoShadowRoot<'dom>>

The shadow root which roots the subtree this element is contained in.

fn implicit_scope_for_sheet_in_shadow_root( opaque_host: OpaqueElement, sheet_index: usize, ) -> Option<ImplicitScopeRoot>

Returns the implicit scope root for given sheet index and host.

type ConcreteNode = ServoLayoutNode<'dom>

The concrete node type.

type TraversalChildrenIterator = DOMDescendantIterator<ServoLayoutElement<'dom>>

A concrete children iterator type in order to iterate over the Nodes.

fn as_node(&self) -> ServoLayoutNode<'dom>

Get this element as a node.

fn traversal_children(&self) -> LayoutIterator<Self::TraversalChildrenIterator>

Get this node’s children from the perspective of a restyle traversal.

fn traversal_parent(&self) -> Option<Self>

Get this node’s parent element from the perspective of a restyle traversal.

fn inheritance_parent(&self) -> Option<Self>

Returns the parent element we should inherit from.

fn is_html_element(&self) -> bool

Return whether this element is an element in the HTML namespace.

fn is_mathml_element(&self) -> bool

Return whether this element is an element in the MathML namespace.

fn is_svg_element(&self) -> bool

Return whether this element is an element in the SVG namespace.

fn has_part_attr(&self) -> bool

Returns whether this element has a part attribute.

fn exports_any_part(&self) -> bool

Returns whether this element exports any part from its shadow tree.

fn style_attribute( &self, ) -> Option<ArcBorrow<'_, StyleLocked<PropertyDeclarationBlock>>>

Get this element’s style attribute.

fn may_have_animations(&self) -> bool

In Gecko, element has a flag that represents the element may have any type of animations or not to bail out animation stuff early. Whereas Servo doesn’t have such flag.

fn animation_rule( &self, context: &SharedStyleContext<'_>, ) -> Option<Arc<StyleLocked<PropertyDeclarationBlock>>>

Get this element’s animation rule.

fn transition_rule( &self, context: &SharedStyleContext<'_>, ) -> Option<Arc<StyleLocked<PropertyDeclarationBlock>>>

Get this element’s transition rule.

fn state(&self) -> ElementState

Get this element’s state, for non-tree-structural pseudos.

fn id(&self) -> Option<&Atom>

The ID for this element.

fn each_class<F>(&self, callback: F)

where F: FnMut(&AtomIdent),

Internal iterator for the classes of this element.

fn each_attr_name<F>(&self, callback: F)

where F: FnMut(&LocalName),

Internal iterator for the attribute names of this element.

fn each_part<F>(&self, callback: F)

where F: FnMut(&AtomIdent),

Internal iterator for the part names of this element.

fn each_exported_part<F>(&self, name: &AtomIdent, callback: F)

where F: FnMut(&AtomIdent),

Internal iterator for the part names that this element exports for a given part name.

fn has_dirty_descendants(&self) -> bool

Returns true if this element may have a descendant needing style processing.

fn has_snapshot(&self) -> bool

Returns whether state or attributes that may change style have changed on the element, and thus whether the element has been snapshotted to do restyle hint computation.

fn handled_snapshot(&self) -> bool

Returns whether the current snapshot if present has been handled.

unsafe fn set_handled_snapshot(&self)

Flags this element as having handled already its snapshot.

unsafe fn set_dirty_descendants(&self)

Flag that this element has a descendant for style processing.

unsafe fn unset_dirty_descendants(&self)

Flag that this element has no descendant for style processing.

fn store_children_to_process(&self, n: isize)

Atomically stores the number of children of this node that we will need to process during bottom-up traversal.

fn did_process_child(&self) -> isize

Atomically notes that a child has been processed during bottom-up traversal. Returns the number of children left to process.

unsafe fn clear_data(&self)

Clears the element data reference, if any.

unsafe fn ensure_data(&self) -> AtomicRefMut<'_, ElementData>

Gets a reference to the ElementData container, or creates one.

fn skip_item_display_fixup(&self) -> bool

Whether we should skip any root- or item-based display property blockification on this element. (This function exists so that Gecko native anonymous content can opt out of this style fixup.)

fn has_animations(&self, context: &SharedStyleContext<'_>) -> bool

Returns true if the element has relevant animations. Relevant animations are those animations that are affecting the element’s style or are scheduled to do so in the future.

fn has_css_animations( &self, context: &SharedStyleContext<'_>, pseudo_element: Option<PseudoElement>, ) -> bool

Returns true if the element has a CSS animation. The context and pseudo_element arguments are only used by Servo, since it stores animations globally and pseudo-elements are not in the DOM.

fn has_css_transitions( &self, context: &SharedStyleContext<'_>, pseudo_element: Option<PseudoElement>, ) -> bool

Returns true if the element has a CSS transition (including running transitions and completed transitions). The context and pseudo_element arguments are only used by Servo, since it stores animations globally and pseudo-elements are not in the DOM.

fn lang_attr(&self) -> Option<SelectorAttrValue>

Returns the value of the xml:lang="" attribute (or, if appropriate, the lang="" attribute) on this element.

fn match_element_lang( &self, override_lang: Option<Option<SelectorAttrValue>>, value: &Lang, ) -> bool

Returns whether this element’s language matches the language tag value. If override_lang is not None, it specifies the value of the xml:lang="" or lang="" attribute to use in place of looking at the element and its ancestors. (This argument is used to implement matching of :lang() against snapshots.)

fn is_html_document_body_element(&self) -> bool

Returns whether this element is the main body element of the HTML document it is on.

fn synthesize_presentational_hints_for_legacy_attributes<V>( &self, _visited_handling: VisitedHandlingMode, hints: &mut V, )

where V: Push<ApplicableDeclarationBlock>,

Generate the proper applicable declarations due to presentational hints, and insert them into hints.

fn local_name(&self) -> &LocalName

Returns element’s local name.

fn namespace(&self) -> &Namespace

Returns element’s namespace.

fn query_container_size(&self, _display: &Display) -> Size2D<Option<Au>>

Returns the size of the element to be used in container size queries. This will usually be the size of the content area of the primary box, but can be None if there is no box or if some axis lacks size containment.

fn has_selector_flags(&self, flags: ElementSelectorFlags) -> bool

Returns true if the element has all of specified selector flags.

fn relative_selector_search_direction(&self) -> ElementSelectorFlags

Returns the search direction for relative selector invalidation, if it is on the search path.

fn each_custom_state<F>(&self, callback: F)

where F: FnMut(&AtomIdent),

Internal iterator for the classes of this element.

fn slotted_nodes(&self) -> &[Self::ConcreteNode]

Return the list of slotted nodes of this node.

fn compute_layout_damage( old: &ComputedValues, new: &ComputedValues, ) -> RestyleDamage

Compute the damage incurred by the change from the _old to _new.

fn owner_doc_matches_for_testing(&self, _: &Device) -> bool

A debug-only check that the device’s owner doc matches the actual doc we’re the root of.

fn each_anonymous_content_child<F>(&self, _f: F)

where F: FnMut(Self),

Execute f for each anonymous content child (apart from ::before and ::after) whose originating element is self.

fn is_xul_element(&self) -> bool

Return whether this element is an element in the XUL namespace.

fn unset_dirty_style_attribute(&self)

Unset the style attribute’s dirty bit. Servo doesn’t need to manage ditry bit for style attribute.

fn smil_override( &self, ) -> Option<ArcBorrow<'_, Locked<PropertyDeclarationBlock>>>

Get this element’s SMIL override declarations.

fn animation_declarations( &self, context: &SharedStyleContext<'_>, ) -> AnimationDeclarations

Get the combined animation and transition rules.

fn may_generate_pseudo( &self, pseudo: &PseudoElement, _primary_style: &ComputedValues, ) -> bool

Whether a given element may generate a pseudo-element.

fn has_current_styles(&self, data: &ElementData) -> bool

Returns whether the element’s styles are up-to-date after traversal (i.e. in post traversal).

fn has_animation_only_dirty_descendants(&self) -> bool

Similar to the dirty_descendants but for representing a descendant of the element needs to be updated in animation-only traversal.

unsafe fn set_animation_only_dirty_descendants(&self)

Flag that this element has a descendant for animation-only restyle processing.

unsafe fn unset_animation_only_dirty_descendants(&self)

Flag that this element has no descendant for animation-only restyle processing.

unsafe fn clear_descendant_bits(&self)

Clear all bits related describing the dirtiness of descendants.

fn is_visited_link(&self) -> bool

Returns true if this element is a visited link.

fn has_animation_restyle_hints(&self) -> bool

Returns true if the element has animation restyle hints.

fn rule_hash_target(&self) -> Self

Return the element which we can use to look up rules in the selector maps.

fn each_applicable_non_document_style_rule_data<'a, F>(&self, f: F) -> bool

where Self: 'a, F: FnMut(&'a CascadeData, Self),

Executes the callback for each applicable style rule data which isn’t the main document’s data (which stores UA / author rules).

fn synthesize_view_transition_dynamic_rules<V>(&self, _rules: &mut V)

where V: Push<ApplicableDeclarationBlock>,

Generate the proper applicable declarations due to view transition dynamic rules, and insert them into rules. https://drafts.csswg.org/css-view-transitions-1/#document-dynamic-view-transition-style-sheet

impl<'dom> Copy for ServoLayoutElement<'dom>

impl<'dom> Eq for ServoLayoutElement<'dom>

impl<'dom> StructuralPartialEq for ServoLayoutElement<'dom>