/* 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 strict"; const EventEmitter = require("devtools/shared/event-emitter"); loader.lazyRequireGetter( this, "nodeConstants", "devtools/shared/dom-node-constants" ); /** * Selection is a singleton belonging to the Toolbox that manages the current selected * NodeFront. In addition, it provides some helpers about the context of the selected * node. * * API * * new Selection() * destroy() * nodeFront (readonly) * setNodeFront(node, origin="unknown") * * Helpers: * * window * document * isRoot() * isNode() * isHTMLNode() * * Check the nature of the node: * * isElementNode() * isAttributeNode() * isTextNode() * isCDATANode() * isEntityRefNode() * isEntityNode() * isProcessingInstructionNode() * isCommentNode() * isDocumentNode() * isDocumentTypeNode() * isDocumentFragmentNode() * isNotationNode() * * Events: * "new-node-front" when the inner node changed * "attribute-changed" when an attribute is changed * "detached-front" when the node (or one of its parents) is removed from * the document * "reparented" when the node (or one of its parents) is moved under * a different node */ function Selection() { EventEmitter.decorate(this); // The WalkerFront is dynamic and is always set to the selected NodeFront's WalkerFront. this._walker = null; // A single node front can be represented twice on the client when the node is a slotted // element. It will be displayed once as a direct child of the host element, and once as // a child of a slot in the "shadow DOM". The latter is called the slotted version. this._isSlotted = false; this._onMutations = this._onMutations.bind(this); this.setNodeFront = this.setNodeFront.bind(this); } Selection.prototype = { _onMutations: function(mutations) { let attributeChange = false; let pseudoChange = false; let detached = false; let parentNode = null; for (const m of mutations) { if (!attributeChange && m.type == "attributes") { attributeChange = true; } if (m.type == "childList") { if (!detached && !this.isConnected()) { if (this.isNode()) { parentNode = m.target; } detached = true; } } if (m.type == "pseudoClassLock") { pseudoChange = true; } } // Fire our events depending on what changed in the mutations array if (attributeChange) { this.emit("attribute-changed"); } if (pseudoChange) { this.emit("pseudoclass"); } if (detached) { this.emit("detached-front", parentNode); } }, destroy: function() { this.setWalker(); }, setWalker: function(walker = null) { if (this._walker) { this._walker.off("mutations", this._onMutations); } this._walker = walker; if (this._walker) { this._walker.on("mutations", this._onMutations); } }, /** * Update the currently selected node-front. * * @param {NodeFront} nodeFront * The NodeFront being selected. * @param {Object} (optional) * - {String} reason: Reason that triggered the selection, will be fired with * the "new-node-front" event. * - {Boolean} isSlotted: Is the selection representing the slotted version of * the node. */ setNodeFront: function( nodeFront, { reason = "unknown", isSlotted = false } = {} ) { this.reason = reason; // If an inlineTextChild text node is being set, then set it's parent instead. const parentNode = nodeFront && nodeFront.parentNode(); if (nodeFront && parentNode && parentNode.inlineTextChild === nodeFront) { nodeFront = parentNode; } if (this._nodeFront == null && nodeFront == null) { // Avoid to notify multiple "unselected" events with a null/undefined nodeFront // (e.g. once when the webpage start to navigate away from the current webpage, // and then again while the new page is being loaded). return; } this._isSlotted = isSlotted; this._nodeFront = nodeFront; if (nodeFront) { this.setWalker(nodeFront.walkerFront); } else { this.setWalker(); } this.emit("new-node-front", nodeFront, this.reason); }, get nodeFront() { return this._nodeFront; }, isRoot: function() { return ( this.isNode() && this.isConnected() && this._nodeFront.isDocumentElement ); }, isNode: function() { return !!this._nodeFront; }, isConnected: function() { let node = this._nodeFront; if (!node || node.isDestroyed()) { return false; } while (node) { if (node === this._walker.rootNode) { return true; } node = node.parentOrHost(); } return false; }, isHTMLNode: function() { const xhtmlNs = "http://www.w3.org/1999/xhtml"; return this.isNode() && this.nodeFront.namespaceURI == xhtmlNs; }, // Node type isElementNode: function() { return ( this.isNode() && this.nodeFront.nodeType == nodeConstants.ELEMENT_NODE ); }, isPseudoElementNode: function() { return this.isNode() && this.nodeFront.isPseudoElement; }, isAnonymousNode: function() { return this.isNode() && this.nodeFront.isAnonymous; }, isAttributeNode: function() { return ( this.isNode() && this.nodeFront.nodeType == nodeConstants.ATTRIBUTE_NODE ); }, isTextNode: function() { return this.isNode() && this.nodeFront.nodeType == nodeConstants.TEXT_NODE; }, isCDATANode: function() { return ( this.isNode() && this.nodeFront.nodeType == nodeConstants.CDATA_SECTION_NODE ); }, isEntityRefNode: function() { return ( this.isNode() && this.nodeFront.nodeType == nodeConstants.ENTITY_REFERENCE_NODE ); }, isEntityNode: function() { return ( this.isNode() && this.nodeFront.nodeType == nodeConstants.ENTITY_NODE ); }, isProcessingInstructionNode: function() { return ( this.isNode() && this.nodeFront.nodeType == nodeConstants.PROCESSING_INSTRUCTION_NODE ); }, isCommentNode: function() { return ( this.isNode() && this.nodeFront.nodeType == nodeConstants.PROCESSING_INSTRUCTION_NODE ); }, isDocumentNode: function() { return ( this.isNode() && this.nodeFront.nodeType == nodeConstants.DOCUMENT_NODE ); }, /** * @returns true if the selection is the HTML element. */ isBodyNode: function() { return ( this.isHTMLNode() && this.isConnected() && this.nodeFront.nodeName === "BODY" ); }, /** * @returns true if the selection is the HTML element. */ isHeadNode: function() { return ( this.isHTMLNode() && this.isConnected() && this.nodeFront.nodeName === "HEAD" ); }, isDocumentTypeNode: function() { return ( this.isNode() && this.nodeFront.nodeType == nodeConstants.DOCUMENT_TYPE_NODE ); }, isDocumentFragmentNode: function() { return ( this.isNode() && this.nodeFront.nodeType == nodeConstants.DOCUMENT_FRAGMENT_NODE ); }, isNotationNode: function() { return ( this.isNode() && this.nodeFront.nodeType == nodeConstants.NOTATION_NODE ); }, isSlotted: function() { return this._isSlotted; }, isShadowRootNode: function() { return this.isNode() && this.nodeFront.isShadowRoot; }, }; module.exports = Selection;