gecko-dev/dom/webidl/InputEvent.webidl
Masayuki Nakano 6eadee9e6c Bug 998941 - part 2-1: Implement InputEvent.dataTransfer declared by Input Events r=smaug
InputEvent.dataTransfer is declared by Input Events Level 1 and Level 2 (i.e.,
not UI Events).  It's necessary for "beforeinput" event on contenteditable
elements because of with some InputEvent.inputType values on contenteditable,
InputEvent.dataTransfer is used instead of InputEvent.data.

According to the Chrome's behavior, if InputEvent.dataTransfer is created by
web apps, the DataTransfer object is mutable.  Otherwise, i.e., the event
represents user input, the DataTransfer object is read only.  We should follow
this behavior.

This is enabled by default.

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

--HG--
extra : moz-landing-system : lando
2019-02-19 06:32:11 +00:00

43 lines
1.4 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/.
*/
[Constructor(DOMString type, optional InputEventInit eventInitDict)]
interface InputEvent : UIEvent
{
readonly attribute boolean isComposing;
[Pref="dom.inputevent.inputtype.enabled"]
readonly attribute DOMString inputType;
[Pref="dom.inputevent.data.enabled"]
readonly attribute DOMString? data;
};
dictionary InputEventInit : UIEventInit
{
boolean isComposing = false;
DOMString inputType = "";
// NOTE: Currently, default value of `data` attribute is declared as empty
// string by UI Events. However, both Chrome and Safari uses `null`,
// and there is a spec issue about this:
// https://github.com/w3c/uievents/issues/139
// So, we take `null` for compatibility with them.
DOMString? data = null;
};
// https://w3c.github.io/input-events/#interface-InputEvent
// https://rawgit.com/w3c/input-events/v1/index.html#interface-InputEvent
partial interface InputEvent
{
[Pref="dom.inputevent.datatransfer.enabled"]
readonly attribute DataTransfer? dataTransfer;
};
partial dictionary InputEventInit
{
DataTransfer? dataTransfer = null;
};