MDN wants to learn about developers like you: https://qsurvey.mozilla.com/s3/MDN-dev-survey

Перевод не завершен. Пожалуйста, помогите перевести эту статью с английского.

Интерфейс MouseEvent представляет собой событие, которое происходит в результате взаимодествия пользователя с  манипулятором ( например, мышью). Наиболее частые из таких событий: click, dblclick, mouseup, mousedown.

MouseEvent выводится из метода UIEvent, который в свою очередь происходит из метода Event. Метод MouseEvent.initMouseEvent() допустимо использовать для лучшей совместимости с предыдущими версиями, однако, для создания  MouseEvent рекомендуется использовть конструктор метода  MouseEvent().

Несколько более конкретные события, производные от события mouseevent: WheelEvent and DragEvent.

Конструктор

MouseEvent()
Создает объект MouseEvent.

Свойства

Данный интерфес наследует свойства от родителей UIEvent и Event.

MouseEvent.altKey Только для чтения
Возвращает значение true, если клавиша  alt была нажата во время движения мыши.
MouseEvent.button Только для чтения
Представляет код клавиши, нажатой в то время, когда произошло событие мыши.
MouseEvent.buttons Только для чтения

Отображает, какие клавиши были нажаты во время движения мыши.

MouseEvent.clientX Только для чтения
Отображение X координат курсора мыши в локальной системе координат (DOM контент).
MouseEvent.clientY Только для чтения
Отображение Y координат курсора мыши в локальной системе координат (DOM контент).
MouseEvent.ctrlKey Только для чтения
Возвращает значение true, если клавиша control была нажата во время движения мыши.
MouseEvent.metaKey Только для чтения
Возвращает значение true, если клавиша meta была нажата во время движения мыши.
MouseEvent.movementX Только для чтения
Отображает X координат указателя мыши относительно позиции последнего mousemove события.
MouseEvent.movementY Только для чтения
Отображает Y координат указателя мыши относительно позиции последнего mousemove события.
MouseEvent.offsetX Только для чтения
Отображает X координат указателя мыши относительно позиции границы отступа целевого узла.
MouseEvent.offsetY Только для чтения
Отображает Y координат указателя мыши относительно позиции границы отступа целевого узла.
MouseEvent.pageX Только для чтения
Отображает X координат указателя мыши относительно всего документа.
MouseEvent.pageY Только для чтения
Отображает Y координат указателя мыши относительно всего документа.
MouseEvent.region Только для чтения
Возвращает id затронутого событием региона. Если ни какой регион затронут не был, возвращает null.
MouseEvent.relatedTarget Только для чтения
Второстепенная цель события, если таковая есть.
MouseEvent.screenX Только для чтения
Отображает X координат указателя мыши в пространстве экрана.
MouseEvent.screenY Только для чтения
Отображает Y координат указателя мыши в пространстве экрана.
MouseEvent.shiftKey Только для чтения
Возвращает true если клавиша shift была нажата, когда произошло событие мыши.
MouseEvent.which Только для чтения
The button being pressed when the mouse event was fired.
MouseEvent.mozPressure Только для чтения
The amount of pressure applied to a touch or tablet device when generating the event; this value ranges between 0.0 (minimum pressure) and 1.0 (maximum pressure).
MouseEvent.mozInputSource Только для чтения

The type of device that generated the event (one of the MOZ_SOURCE_* constants listed below). This lets you, for example, determine whether a mouse event was generated by an actual mouse or by a touch event (which might affect the degree of accuracy with which you interpret the coordinates associated with the event).

MouseEvent.webkitForce Только для чтения
The amount of pressure applied when clicking
MouseEvent.x Только для чтения
Alias for MouseEvent.clientX.
MouseEvent.y Только для чтения
Alias for MouseEvent.clientY

Константы

MouseEvent.WEBKIT_FORCE_AT_MOUSE_DOWN Только для чтения
Minimum force necessary for a normal click
MouseEvent.WEBKIT_FORCE_AT_FORCE_MOUSE_DOWN Только для чтения
Minimum force necessary for a force click

Методы

Данный интерфес наследует свойства от родителей, UIEvent and Event.

MouseEvent.getModifierState()
Returns the current state of the specified modifier key. See the KeyboardEvent.getModifierState() for details.
MouseEvent.initMouseEvent()
Initializes the value of a MouseEvent created. If the event has already being dispatched, this method does nothing.

Примеры

Данный пример демонстрирует симуляцию нажатия левой клавиши мыши (событие мыши генерируется программно) по чекбоксу используя методы DOM.

function simulateClick() {
  var evt = new MouseEvent("click", {
    bubbles: true,
    cancelable: true,
    view: window
  });
  var cb = document.getElementById("checkbox"); //element to click on
  var canceled = !cb.dispatchEvent(evt);
  if(canceled) {
    // A handler called preventDefault
    alert("canceled");
  } else {
    // None of the handlers called preventDefault
    alert("not canceled");
  }
}
document.getElementById("button").addEventListener('click', simulateClick);
<p><label><input type="checkbox" id="checkbox"> Checked</label>
<p><button id="button">Click me</button>

Нажмите на кнопку, чтобы посмотреть, как работает пример.

Спецификации

Спецификация Статус Комментарий
WHATWG HTML Living Standard
Определение 'MouseEvent.region' в этой спецификации.
Живой стандарт From Document Object Model (DOM) Level 3 Events Specification, added the region property.
Pointer Lock
Определение 'MouseEvent' в этой спецификации.
Кандидат в рекомендации From Document Object Model (DOM) Level 3 Events Specification, added movementX and movementY properties.
CSS Object Model (CSSOM) View Module
Определение 'MouseEvent' в этой спецификации.
Рабочий черновик From Document Object Model (DOM) Level 3 Events Specification, added offsetX and offsetY, pageX and pageY, x, and y properties.
Document Object Model (DOM) Level 3 Events Specification
Определение 'MouseEvent' в этой спецификации.
Рабочий черновик From Document Object Model (DOM) Level 2 Events Specification, added the MouseEvent() constructor, the getModifierState() method and the buttons property.
Document Object Model (DOM) Level 2 Events Specification
Определение 'MouseEvent' в этой спецификации.
Рекомендация Initial definition.

Совместимость с браузерами

Возможность Firefox (Gecko) Edge Chrome Internet Explorer Opera Safari
Базовая поддержка (Да) (Да) (Да) (Да) (Да) (Да)
movementX
movementY
(Да) moz (Да) (Да) ? (Да) ?
buttons (Да) (Да) 43 ? ? Нет
which 1.0 (Да) 1.0 9.0 5.0 1.0
getModifierState() 15 (15) (Да) (Да) (Да) (Да) (Да)
mozPressure and mozInputSource 4.0 (2) ? Нет Нет Нет Нет
MouseEvent() 11 (11) ? (Да) 9.0 (Да) ?
MouseEvent.region 32 (32) ? ? ? ? ?
MouseEvent.offsetX, and MouseEvent.offsetY 40 (40) 9 ? ? ? ?
Возможность Firefox Mobile (Gecko) Android IE Mobile Opera Mobile Safari Mobile
Базовая поддержка ? ? ? ? ?

See also

Метки документа и участники

 Внесли вклад в эту страницу: swymmwys, LidiyaU, muichikawa
 Обновлялась последний раз: swymmwys,