summaryrefslogtreecommitdiffstats
path: root/dom/webidl/DataTransfer.webidl
diff options
context:
space:
mode:
authorDaniel Baumann <daniel.baumann@progress-linux.org>2024-04-19 00:47:55 +0000
committerDaniel Baumann <daniel.baumann@progress-linux.org>2024-04-19 00:47:55 +0000
commit26a029d407be480d791972afb5975cf62c9360a6 (patch)
treef435a8308119effd964b339f76abb83a57c29483 /dom/webidl/DataTransfer.webidl
parentInitial commit. (diff)
downloadfirefox-26a029d407be480d791972afb5975cf62c9360a6.tar.xz
firefox-26a029d407be480d791972afb5975cf62c9360a6.zip
Adding upstream version 124.0.1.upstream/124.0.1
Signed-off-by: Daniel Baumann <daniel.baumann@progress-linux.org>
Diffstat (limited to 'dom/webidl/DataTransfer.webidl')
-rw-r--r--dom/webidl/DataTransfer.webidl190
1 files changed, 190 insertions, 0 deletions
diff --git a/dom/webidl/DataTransfer.webidl b/dom/webidl/DataTransfer.webidl
new file mode 100644
index 0000000000..bcdb98f547
--- /dev/null
+++ b/dom/webidl/DataTransfer.webidl
@@ -0,0 +1,190 @@
+/* -*- 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:
+ * http://www.whatwg.org/specs/web-apps/current-work/#the-datatransfer-interface
+ */
+interface ContentSecurityPolicy;
+
+[Exposed=Window]
+interface DataTransfer {
+ constructor();
+
+ attribute DOMString dropEffect;
+ attribute DOMString effectAllowed;
+
+ readonly attribute DataTransferItemList items;
+
+ undefined setDragImage(Element image, long x, long y);
+
+ [Frozen, Cached, Pure, NeedsCallerType]
+ readonly attribute sequence<DOMString> types;
+ [Throws, NeedsSubjectPrincipal]
+ DOMString getData(DOMString format);
+ [Throws, NeedsSubjectPrincipal]
+ undefined setData(DOMString format, DOMString data);
+ [Throws, NeedsSubjectPrincipal]
+ undefined clearData(optional DOMString format);
+ [NeedsSubjectPrincipal]
+ readonly attribute FileList? files;
+};
+
+// Mozilla specific stuff
+partial interface DataTransfer {
+ /*
+ * Set the drag source. Usually you would not change this, but it will
+ * affect which node the drag and dragend events are fired at. The
+ * default target is the node that was dragged.
+ *
+ * @param element drag source to use
+ * @throws NO_MODIFICATION_ALLOWED_ERR if the item cannot be modified
+ */
+ [Throws, UseCounter]
+ undefined addElement(Element element);
+
+ /**
+ * The number of items being dragged.
+ */
+ [ChromeOnly]
+ readonly attribute unsigned long mozItemCount;
+
+ /**
+ * Sets the drag cursor state. Primarily used to control the cursor during
+ * tab drags, but could be expanded to other uses. XXX Currently implemented
+ * on Win32 only.
+ *
+ * Possible values:
+ * auto - use default system behavior.
+ * default - set the cursor to an arrow during the drag operation.
+ *
+ * Values other than 'default' are indentical to setting mozCursor to
+ * 'auto'.
+ */
+ [UseCounter]
+ attribute DOMString mozCursor;
+
+ /**
+ * Holds a list of the format types of the data that is stored for an item
+ * at the specified index. If the index is not in the range from 0 to
+ * itemCount - 1, an empty string list is returned.
+ */
+ [Throws, ChromeOnly]
+ DOMStringList mozTypesAt(unsigned long index);
+
+ /**
+ * Remove the data associated with the given format for an item at the
+ * specified index. The index is in the range from zero to itemCount - 1.
+ *
+ * If the last format for the item is removed, the entire item is removed,
+ * reducing the itemCount by one.
+ *
+ * If format is empty, then the data associated with all formats is removed.
+ * If the format is not found, then this method has no effect.
+ *
+ * @param format the format to remove
+ * @throws NS_ERROR_DOM_INDEX_SIZE_ERR if index is greater or equal than itemCount
+ * @throws NO_MODIFICATION_ALLOWED_ERR if the item cannot be modified
+ */
+ [Throws, ChromeOnly]
+ undefined mozClearDataAt(DOMString format, unsigned long index);
+
+ /*
+ * A data transfer may store multiple items, each at a given zero-based
+ * index. setDataAt may only be called with an index argument less than
+ * itemCount in which case an existing item is modified, or equal to
+ * itemCount in which case a new item is added, and the itemCount is
+ * incremented by one.
+ *
+ * Data should be added in order of preference, with the most specific
+ * format added first and the least specific format added last. If data of
+ * the given format already exists, it is replaced in the same position as
+ * the old data.
+ *
+ * The data should be either a string, a primitive boolean or number type
+ * (which will be converted into a string) or an nsISupports.
+ *
+ * @param format the format to add
+ * @param data the data to add
+ * @throws NS_ERROR_NULL_POINTER if the data is null
+ * @throws NS_ERROR_DOM_INDEX_SIZE_ERR if index is greater than itemCount
+ * @throws NO_MODIFICATION_ALLOWED_ERR if the item cannot be modified
+ */
+ [Throws, ChromeOnly]
+ undefined mozSetDataAt(DOMString format, any data, unsigned long index);
+
+ /**
+ * Retrieve the data associated with the given format for an item at the
+ * specified index, or null if it does not exist. The index should be in the
+ * range from zero to itemCount - 1.
+ *
+ * @param format the format of the data to look up
+ * @returns the data of the given format, or null if it doesn't exist.
+ * @throws NS_ERROR_DOM_INDEX_SIZE_ERR if index is greater or equal than itemCount
+ */
+ [Throws, ChromeOnly]
+ any mozGetDataAt(DOMString format, unsigned long index);
+
+ /**
+ * Update the drag image. Arguments are the same as setDragImage. This is only
+ * valid within the parent chrome process.
+ */
+ [ChromeOnly]
+ undefined updateDragImage(Element image, long x, long y);
+
+ /**
+ * Will be true when the user has cancelled the drag (typically by pressing
+ * Escape) and when the drag has been cancelled unexpectedly. This will be
+ * false otherwise, including when the drop has been rejected by its target.
+ * This property is only relevant for the dragend event.
+ */
+ [UseCounter]
+ readonly attribute boolean mozUserCancelled;
+
+ /**
+ * The node that the mouse was pressed over to begin the drag. For external
+ * drags, or if the caller cannot access this node, this will be null.
+ */
+ [UseCounter]
+ readonly attribute Node? mozSourceNode;
+
+ /**
+ * The top-level window context that mouse was pressed over to begin the drag.
+ * For external drags, this will be null.
+ */
+ [ChromeOnly]
+ readonly attribute WindowContext? sourceTopWindowContext;
+
+ /**
+ * The URI spec of the triggering principal. This may be different than
+ * sourceNode's principal when sourceNode is xul:browser and the drag is
+ * triggered in a browsing context inside it.
+ */
+ [ChromeOnly]
+ readonly attribute DOMString mozTriggeringPrincipalURISpec;
+
+ [ChromeOnly]
+ readonly attribute ContentSecurityPolicy? mozCSP;
+
+ /**
+ * Copy the given DataTransfer for the given event. Used by testing code for
+ * creating emulated Drag and Drop events in the UI.
+ *
+ * NOTE: Don't expose a DataTransfer produced with this method to the web or
+ * use this for non-testing purposes. It can easily be used to get the
+ * DataTransfer into an invalid state, and is an unstable implementation
+ * detail of EventUtils.synthesizeDrag.
+ */
+ [Throws, ChromeOnly]
+ DataTransfer mozCloneForEvent(DOMString event);
+
+ /**
+ * Whether to show the "fail" animation that returns a dragged item
+ * to its source. Only works on macOS, and has to be set early in the drag
+ * on that platform.
+ * Defaults to true.
+ */
+ [ChromeOnly]
+ attribute boolean mozShowFailAnimation;
+};