From 26a029d407be480d791972afb5975cf62c9360a6 Mon Sep 17 00:00:00 2001 From: Daniel Baumann Date: Fri, 19 Apr 2024 02:47:55 +0200 Subject: Adding upstream version 124.0.1. Signed-off-by: Daniel Baumann --- dom/webidl/ShadowRoot.webidl | 67 ++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 67 insertions(+) create mode 100644 dom/webidl/ShadowRoot.webidl (limited to 'dom/webidl/ShadowRoot.webidl') diff --git a/dom/webidl/ShadowRoot.webidl b/dom/webidl/ShadowRoot.webidl new file mode 100644 index 0000000000..57051c5e7f --- /dev/null +++ b/dom/webidl/ShadowRoot.webidl @@ -0,0 +1,67 @@ +/* -*- 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, + InstrumentedProps=(pictureInPictureElement)] +interface ShadowRoot : DocumentFragment +{ + // Shadow DOM v1 + readonly attribute ShadowRootMode mode; + readonly attribute boolean delegatesFocus; + readonly attribute SlotAssignmentMode slotAssignment; + [Pref="dom.webcomponents.shadowdom.declarative.enabled"] + readonly attribute boolean clonable; + readonly attribute Element host; + attribute EventHandler onslotchange; + + Element? getElementById(DOMString elementId); + + // https://w3c.github.io/DOM-Parsing/#the-innerhtml-mixin + [CEReactions, SetterThrows] + attribute [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(); +}; + +partial interface ShadowRoot { + // https://html.spec.whatwg.org/#dom-shadowroot-sethtmlunsafe + [Pref="dom.webcomponents.shadowdom.declarative.enabled"] + undefined setHTMLUnsafe(DOMString html); +}; + +ShadowRoot includes DocumentOrShadowRoot; -- cgit v1.2.3