gecko-dev/dom/webidl/ShadowRoot.webidl
Emilio Cobos Álvarez cc63c03558 Bug 1535438 - Remove Shadow DOM v0 APIs. r=smaug
Looks like these three APIs slipped through when shipping v1, but no other
vendor supports them, so no reason to be here.

I don't think there's any harm in letting the implementations keep living in
DocumentOrShadowRoot, but let me know if you think otherwise and I'll move them
to Document.

Differential Revision: https://phabricator.services.mozilla.com/D23577

--HG--
extra : moz-landing-system : lando
2019-03-16 00:14:57 +00:00

52 lines
1.9 KiB
Plaintext

/* -*- Mode: IDL; tab-width: 2; indent-tabs-mode: nil; c-basic-offset: 2 -*- */
/* 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/.
*
* The origin of this IDL file is
* https://dvcs.w3.org/hg/webcomponents/raw-file/tip/spec/shadow/index.html
*
* Copyright © 2012 W3C® (MIT, ERCIM, Keio), All Rights Reserved. W3C
* liability, trademark and document use rules apply.
*/
// https://dom.spec.whatwg.org/#enumdef-shadowrootmode
enum ShadowRootMode {
"open",
"closed"
};
// https://dom.spec.whatwg.org/#shadowroot
interface ShadowRoot : DocumentFragment
{
// Shadow DOM v1
readonly attribute ShadowRootMode mode;
readonly attribute Element host;
Element? getElementById(DOMString elementId);
[CEReactions, SetterThrows]
attribute [TreatNullAs=EmptyString] DOMString innerHTML;
// When JS invokes importNode or createElement, the binding code needs to
// create a reflector, and so invoking those methods directly on the content
// document would cause the reflector to be created in the content scope,
// at which point it would be difficult to move into the UA Widget scope.
// As such, these methods allow UA widget code to simultaneously create nodes
// and associate them with the UA widget tree, so that the reflectors get
// created in the right scope.
[CEReactions, Throws, Func="IsChromeOrXBLOrUAWidget"]
Node importNodeAndAppendChildAt(Node parentNode, Node node, optional boolean deep = false);
[CEReactions, Throws, Func="IsChromeOrXBLOrUAWidget"]
Node createElementAndAppendChildAt(Node parentNode, DOMString localName);
// For triggering UA Widget scope in tests.
[ChromeOnly]
void setIsUAWidget();
[ChromeOnly]
boolean isUAWidget();
};
ShadowRoot implements DocumentOrShadowRoot;