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

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

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

Конструктор

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Не стандартноТолько для чтения

Возвращает код последней нажатой клавиши, когда произошло событие мыши.

MouseEvent.mozPressureНе стандартноТолько для чтения

Отображает давление которое было осуществлено при нажатии. Значение будет между0.0 (минимальное давление) и1.0 (максимальное давление).

MouseEvent.mozInputSourceНе стандартноТолько для чтения

The type of device that generated the event (one of theMOZ_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Не стандартноТолько для чтения

Отображает количество приложенного давления при клике.

MouseEvent.xЭкспериментальная возможностьТолько для чтения

Alias дляMouseEvent.clientX.

MouseEvent.yЭкспериментальная возможностьТолько для чтения

Alias дляMouseEvent.clientY

Константы

MouseEvent.WEBKIT_FORCE_AT_MOUSE_DOWNНе стандартноТолько для чтения

Минимальная необходимая сила для обычного клика

MouseEvent.WEBKIT_FORCE_AT_FORCE_MOUSE_DOWNНе стандартноТолько для чтения

Минимальная необходимая сила для усиленного клика

Методы

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

MouseEvent.getModifierState()

Returns the current state of the specified modifier key. See theKeyboardEvent.getModifierState() for details.

MouseEvent.initMouseEvent()Устарело

Initializes the value of aMouseEvent 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" /> Checked</label></p><p><button>Click me</button></p>

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

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

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

Посмотрите также

• Its direct parent,UIEvent.