1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
|
/* -*- 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"
};
enum SlotAssignmentMode { "manual", "named" };
// https://dom.spec.whatwg.org/#shadowroot
[Exposed=Window]
interface ShadowRoot : DocumentFragment
{
// Shadow DOM v1
readonly attribute ShadowRootMode mode;
readonly attribute boolean delegatesFocus;
readonly attribute SlotAssignmentMode slotAssignment;
readonly attribute boolean clonable;
readonly attribute boolean serializable;
readonly attribute Element host;
attribute EventHandler onslotchange;
[Pref="dom.shadowdom.referenceTarget.enabled"]
attribute DOMString referenceTarget;
Element? getElementById(DOMString elementId);
// https://w3c.github.io/DOM-Parsing/#the-innerhtml-mixin
[CEReactions, SetterThrows, SetterNeedsSubjectPrincipal=NonSystem]
attribute (TrustedHTML or [LegacyNullToEmptyString] 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="IsChromeOrUAWidget"]
Node importNodeAndAppendChildAt(Node parentNode, Node node, optional boolean deep = false);
[CEReactions, Throws, Func="IsChromeOrUAWidget"]
Node createElementAndAppendChildAt(Node parentNode, DOMString localName);
// For triggering UA Widget scope in tests.
[ChromeOnly]
undefined setIsUAWidget();
[ChromeOnly]
boolean isUAWidget();
};
// Sanitizer API, https://wicg.github.io/sanitizer-api/
partial interface ShadowRoot {
[Throws, Pref="dom.security.sanitizer.enabled"]
undefined setHTML(DOMString aInnerHTML, optional SetHTMLOptions options = {});
};
partial interface ShadowRoot {
// https://html.spec.whatwg.org/#dom-shadowroot-sethtmlunsafe
[NeedsSubjectPrincipal=NonSystem, Throws]
undefined setHTMLUnsafe((TrustedHTML or DOMString) html, optional SetHTMLUnsafeOptions options = {});
DOMString getHTML(optional GetHTMLOptions options = {});
};
ShadowRoot includes DocumentOrShadowRoot;
|
