mirror of
https://github.com/servo/servo.git
synced 2025-06-08 08:33:26 +00:00
58e1bd0e57
This replaces before_remove_attr(), after_remove_attr() and after_set_attr(). The virtual method takes the mutated attribute and an AttributeMutation value to disambiguate between "attribute is changed", "attribute is added" and "attribute is removed". In the case of "attribute is changed", the mutation value contains a reference to the old value of the mutated attribute, which is used to unregister outdated named elements when the "id" attribute is changed on an element. This greatly simplifies the handling of attributes, which in many cases don't have any specific behaviour whether they are removed or changed or added. It also fixes a few bugs where things were put in before_remove_attr() instead of after_remove_attr() (e.g. when removing an href attribute from a base element). A few helper functions in Element were also renamed and made private.
240 lines
12 KiB
Rust
240 lines
12 KiB
Rust
/* This Source Code Form is subject to the terms of the Mozilla Public
|
|
* License, v. 2.0. If a copy of the MPL was not distributed with this
|
|
* file, You can obtain one at http://mozilla.org/MPL/2.0/. */
|
|
|
|
use dom::attr::{Attr, AttrValue};
|
|
use dom::bindings::codegen::InheritTypes::ElementCast;
|
|
use dom::bindings::codegen::InheritTypes::HTMLAnchorElementCast;
|
|
use dom::bindings::codegen::InheritTypes::HTMLAppletElementCast;
|
|
use dom::bindings::codegen::InheritTypes::HTMLAreaElementCast;
|
|
use dom::bindings::codegen::InheritTypes::HTMLBaseElementCast;
|
|
use dom::bindings::codegen::InheritTypes::HTMLBodyElementCast;
|
|
use dom::bindings::codegen::InheritTypes::HTMLButtonElementCast;
|
|
use dom::bindings::codegen::InheritTypes::HTMLCanvasElementCast;
|
|
use dom::bindings::codegen::InheritTypes::HTMLElementCast;
|
|
use dom::bindings::codegen::InheritTypes::HTMLFieldSetElementCast;
|
|
use dom::bindings::codegen::InheritTypes::HTMLFontElementCast;
|
|
use dom::bindings::codegen::InheritTypes::HTMLFormElementCast;
|
|
use dom::bindings::codegen::InheritTypes::HTMLHeadElementCast;
|
|
use dom::bindings::codegen::InheritTypes::HTMLIFrameElementCast;
|
|
use dom::bindings::codegen::InheritTypes::HTMLImageElementCast;
|
|
use dom::bindings::codegen::InheritTypes::HTMLInputElementCast;
|
|
use dom::bindings::codegen::InheritTypes::HTMLLinkElementCast;
|
|
use dom::bindings::codegen::InheritTypes::HTMLObjectElementCast;
|
|
use dom::bindings::codegen::InheritTypes::HTMLOptGroupElementCast;
|
|
use dom::bindings::codegen::InheritTypes::HTMLOptionElementCast;
|
|
use dom::bindings::codegen::InheritTypes::HTMLScriptElementCast;
|
|
use dom::bindings::codegen::InheritTypes::HTMLSelectElementCast;
|
|
use dom::bindings::codegen::InheritTypes::HTMLStyleElementCast;
|
|
use dom::bindings::codegen::InheritTypes::HTMLTableCellElementCast;
|
|
use dom::bindings::codegen::InheritTypes::HTMLTableElementCast;
|
|
use dom::bindings::codegen::InheritTypes::HTMLTableRowElementCast;
|
|
use dom::bindings::codegen::InheritTypes::HTMLTableSectionElementCast;
|
|
use dom::bindings::codegen::InheritTypes::HTMLTextAreaElementCast;
|
|
use dom::bindings::codegen::InheritTypes::HTMLTitleElementCast;
|
|
use dom::document::Document;
|
|
use dom::element::{AttributeMutation, ElementTypeId};
|
|
use dom::event::Event;
|
|
use dom::htmlelement::HTMLElementTypeId;
|
|
use dom::node::NodeTypeId;
|
|
use dom::node::{ChildrenMutation, CloneChildrenFlag, Node};
|
|
|
|
use util::str::DOMString;
|
|
|
|
use string_cache::Atom;
|
|
|
|
/// Trait to allow DOM nodes to opt-in to overriding (or adding to) common
|
|
/// behaviours. Replicates the effect of C++ virtual methods.
|
|
pub trait VirtualMethods {
|
|
/// Returns self as the superclass of the implementation for this trait,
|
|
/// if any.
|
|
fn super_type(&self) -> Option<&VirtualMethods>;
|
|
|
|
/// 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_mutated(&self, attr: &Attr, mutation: AttributeMutation) {
|
|
if let Some(s) = self.super_type() {
|
|
s.attribute_mutated(attr, mutation);
|
|
}
|
|
}
|
|
|
|
/// Returns the right AttrValue variant for the attribute with name `name`
|
|
/// on this element.
|
|
fn parse_plain_attribute(&self, name: &Atom, value: DOMString) -> AttrValue {
|
|
match self.super_type() {
|
|
Some(ref s) => s.parse_plain_attribute(name, value),
|
|
_ => AttrValue::String(value),
|
|
}
|
|
}
|
|
|
|
/// Called when a Node is appended to a tree, where 'tree_in_doc' indicates
|
|
/// whether the tree is part of a Document.
|
|
fn bind_to_tree(&self, tree_in_doc: bool) {
|
|
if let Some(ref s) = self.super_type() {
|
|
s.bind_to_tree(tree_in_doc);
|
|
}
|
|
}
|
|
|
|
/// Called when a Node is removed from a tree, where 'tree_in_doc'
|
|
/// indicates whether the tree is part of a Document.
|
|
fn unbind_from_tree(&self, tree_in_doc: bool) {
|
|
if let Some(ref s) = self.super_type() {
|
|
s.unbind_from_tree(tree_in_doc);
|
|
}
|
|
}
|
|
|
|
/// Called on the parent when its children are changed.
|
|
fn children_changed(&self, mutation: &ChildrenMutation) {
|
|
if let Some(ref s) = self.super_type() {
|
|
s.children_changed(mutation);
|
|
}
|
|
}
|
|
|
|
/// Called during event dispatch after the bubbling phase completes.
|
|
fn handle_event(&self, event: &Event) {
|
|
if let Some(s) = self.super_type() {
|
|
s.handle_event(event);
|
|
}
|
|
}
|
|
|
|
/// https://dom.spec.whatwg.org/#concept-node-clone (step 5)
|
|
fn cloning_steps(&self, copy: &Node, maybe_doc: Option<&Document>,
|
|
clone_children: CloneChildrenFlag) {
|
|
if let Some(ref s) = self.super_type() {
|
|
s.cloning_steps(copy, maybe_doc, clone_children);
|
|
}
|
|
}
|
|
}
|
|
|
|
/// Obtain a VirtualMethods instance for a given Node-derived object. Any
|
|
/// method call on the trait object will invoke the corresponding method on the
|
|
/// concrete type, propagating up the parent hierarchy unless otherwise
|
|
/// interrupted.
|
|
pub fn vtable_for<'a>(node: &'a Node) -> &'a (VirtualMethods + 'a) {
|
|
match node.type_id() {
|
|
NodeTypeId::Element(ElementTypeId::HTMLElement(HTMLElementTypeId::HTMLAnchorElement)) => {
|
|
let element = HTMLAnchorElementCast::to_ref(node).unwrap();
|
|
element as &'a (VirtualMethods + 'a)
|
|
}
|
|
NodeTypeId::Element(ElementTypeId::HTMLElement(HTMLElementTypeId::HTMLAppletElement)) => {
|
|
HTMLAppletElementCast::to_ref(node).unwrap() as &'a (VirtualMethods + 'a)
|
|
}
|
|
NodeTypeId::Element(ElementTypeId::HTMLElement(HTMLElementTypeId::HTMLAreaElement)) => {
|
|
let element = HTMLAreaElementCast::to_ref(node).unwrap();
|
|
element as &'a (VirtualMethods + 'a)
|
|
}
|
|
NodeTypeId::Element(ElementTypeId::HTMLElement(HTMLElementTypeId::HTMLBaseElement)) => {
|
|
let element = HTMLBaseElementCast::to_ref(node).unwrap();
|
|
element as &'a (VirtualMethods + 'a)
|
|
}
|
|
NodeTypeId::Element(ElementTypeId::HTMLElement(HTMLElementTypeId::HTMLBodyElement)) => {
|
|
let element = HTMLBodyElementCast::to_ref(node).unwrap();
|
|
element as &'a (VirtualMethods + 'a)
|
|
}
|
|
NodeTypeId::Element(ElementTypeId::HTMLElement(HTMLElementTypeId::HTMLButtonElement)) => {
|
|
let element = HTMLButtonElementCast::to_ref(node).unwrap();
|
|
element as &'a (VirtualMethods + 'a)
|
|
}
|
|
NodeTypeId::Element(ElementTypeId::HTMLElement(HTMLElementTypeId::HTMLCanvasElement)) => {
|
|
let element = HTMLCanvasElementCast::to_ref(node).unwrap();
|
|
element as &'a (VirtualMethods + 'a)
|
|
}
|
|
NodeTypeId::Element(ElementTypeId::HTMLElement(HTMLElementTypeId::HTMLFieldSetElement)) => {
|
|
let element = HTMLFieldSetElementCast::to_ref(node).unwrap();
|
|
element as &'a (VirtualMethods + 'a)
|
|
}
|
|
NodeTypeId::Element(ElementTypeId::HTMLElement(HTMLElementTypeId::HTMLFontElement)) => {
|
|
let element = HTMLFontElementCast::to_ref(node).unwrap();
|
|
element as &'a (VirtualMethods + 'a)
|
|
}
|
|
NodeTypeId::Element(ElementTypeId::HTMLElement(HTMLElementTypeId::HTMLFormElement)) => {
|
|
let element = HTMLFormElementCast::to_ref(node).unwrap();
|
|
element as &'a (VirtualMethods + 'a)
|
|
}
|
|
NodeTypeId::Element(ElementTypeId::HTMLElement(HTMLElementTypeId::HTMLHeadElement)) => {
|
|
let element = HTMLHeadElementCast::to_ref(node).unwrap();
|
|
element as &'a (VirtualMethods + 'a)
|
|
}
|
|
NodeTypeId::Element(ElementTypeId::HTMLElement(HTMLElementTypeId::HTMLImageElement)) => {
|
|
let element = HTMLImageElementCast::to_ref(node).unwrap();
|
|
element as &'a (VirtualMethods + 'a)
|
|
}
|
|
NodeTypeId::Element(ElementTypeId::HTMLElement(HTMLElementTypeId::HTMLIFrameElement)) => {
|
|
let element = HTMLIFrameElementCast::to_ref(node).unwrap();
|
|
element as &'a (VirtualMethods + 'a)
|
|
}
|
|
NodeTypeId::Element(ElementTypeId::HTMLElement(HTMLElementTypeId::HTMLInputElement)) => {
|
|
let element = HTMLInputElementCast::to_ref(node).unwrap();
|
|
element as &'a (VirtualMethods + 'a)
|
|
}
|
|
NodeTypeId::Element(ElementTypeId::HTMLElement(HTMLElementTypeId::HTMLLinkElement)) => {
|
|
let element = HTMLLinkElementCast::to_ref(node).unwrap();
|
|
element as &'a (VirtualMethods + 'a)
|
|
}
|
|
NodeTypeId::Element(ElementTypeId::HTMLElement(HTMLElementTypeId::HTMLObjectElement)) => {
|
|
let element = HTMLObjectElementCast::to_ref(node).unwrap();
|
|
element as &'a (VirtualMethods + 'a)
|
|
}
|
|
NodeTypeId::Element(ElementTypeId::HTMLElement(HTMLElementTypeId::HTMLOptGroupElement)) => {
|
|
let element = HTMLOptGroupElementCast::to_ref(node).unwrap();
|
|
element as &'a (VirtualMethods + 'a)
|
|
}
|
|
NodeTypeId::Element(ElementTypeId::HTMLElement(HTMLElementTypeId::HTMLOptionElement)) => {
|
|
let element = HTMLOptionElementCast::to_ref(node).unwrap();
|
|
element as &'a (VirtualMethods + 'a)
|
|
}
|
|
NodeTypeId::Element(ElementTypeId::HTMLElement(HTMLElementTypeId::HTMLScriptElement)) => {
|
|
let element = HTMLScriptElementCast::to_ref(node).unwrap();
|
|
element as &'a (VirtualMethods + 'a)
|
|
}
|
|
NodeTypeId::Element(ElementTypeId::HTMLElement(HTMLElementTypeId::HTMLSelectElement)) => {
|
|
let element = HTMLSelectElementCast::to_ref(node).unwrap();
|
|
element as &'a (VirtualMethods + 'a)
|
|
}
|
|
NodeTypeId::Element(ElementTypeId::HTMLElement(HTMLElementTypeId::HTMLStyleElement)) => {
|
|
let element = HTMLStyleElementCast::to_ref(node).unwrap();
|
|
element as &'a (VirtualMethods + 'a)
|
|
}
|
|
NodeTypeId::Element(ElementTypeId::HTMLElement(HTMLElementTypeId::HTMLTableElement)) => {
|
|
let element =
|
|
HTMLTableElementCast::to_ref(node).unwrap();
|
|
element as &'a (VirtualMethods + 'a)
|
|
}
|
|
NodeTypeId::Element(ElementTypeId::HTMLElement(HTMLElementTypeId::HTMLTableCellElement(_))) => {
|
|
let element =
|
|
HTMLTableCellElementCast::to_ref(node).unwrap();
|
|
element as &'a (VirtualMethods + 'a)
|
|
}
|
|
NodeTypeId::Element(ElementTypeId::HTMLElement(HTMLElementTypeId::HTMLTableRowElement)) => {
|
|
let element =
|
|
HTMLTableRowElementCast::to_ref(node).unwrap();
|
|
element as &'a (VirtualMethods + 'a)
|
|
}
|
|
NodeTypeId::Element(ElementTypeId::HTMLElement(HTMLElementTypeId::HTMLTableSectionElement)) => {
|
|
let element =
|
|
HTMLTableSectionElementCast::to_ref(node).unwrap();
|
|
element as &'a (VirtualMethods + 'a)
|
|
}
|
|
NodeTypeId::Element(ElementTypeId::HTMLElement(HTMLElementTypeId::HTMLTextAreaElement)) => {
|
|
let element = HTMLTextAreaElementCast::to_ref(node).unwrap();
|
|
element as &'a (VirtualMethods + 'a)
|
|
}
|
|
NodeTypeId::Element(ElementTypeId::HTMLElement(HTMLElementTypeId::HTMLTitleElement)) => {
|
|
let element =
|
|
HTMLTitleElementCast::to_ref(node).unwrap();
|
|
element as &'a (VirtualMethods + 'a)
|
|
}
|
|
NodeTypeId::Element(ElementTypeId::Element) => {
|
|
let element = ElementCast::to_ref(node).unwrap();
|
|
element as &'a (VirtualMethods + 'a)
|
|
}
|
|
NodeTypeId::Element(_) => {
|
|
let element = HTMLElementCast::to_ref(node).unwrap();
|
|
element as &'a (VirtualMethods + 'a)
|
|
}
|
|
_ => {
|
|
node as &'a (VirtualMethods + 'a)
|
|
}
|
|
}
|
|
}
|