MouseEvent
Baseline Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.
Интерфейс 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.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.screenX
Только для чтения-
Отображает X координат указателя мыши в пространстве экрана.
MouseEvent.screenY
Только для чтения-
Отображает Y координат указателя мыши в пространстве экрана.
MouseEvent.shiftKey
Только для чтения-
Возвращает true если клавиша
shift
была нажата, когда произошло событие мыши.
MouseEvent.which
Non-standard Только для чтения-
Возвращает код последней нажатой клавиши, когда произошло событие мыши.
MouseEvent.mozPressure
Non-standard Только для чтения-
Отображает давление которое было осуществлено при нажатии. Значение будет между
0.0
(минимальное давление) и1.0
(максимальное давление). MouseEvent.mozInputSource
Non-standard Только для чтения-
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
Non-standard Только для чтения-
Отображает количество приложенного давления при клике.
MouseEvent.x
Экспериментальная возможность Только для чтения-
Alias для
MouseEvent.clientX
. MouseEvent.y
Экспериментальная возможность Только для чтения-
Alias для
MouseEvent.clientY
Константы
MouseEvent.WEBKIT_FORCE_AT_MOUSE_DOWN
Non-standard Только для чтения-
Минимальная необходимая сила для обычного клика
MouseEvent.WEBKIT_FORCE_AT_FORCE_MOUSE_DOWN
Non-standard Только для чтения-
Минимальная необходимая сила для усиленного клика
Методы
Данный интерфейс наследует свойства от родителей, 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>
<p><button id="button">Click me</button></p>
Нажмите на кнопку, чтобы посмотреть, как работает пример.
Спецификации
Specification |
---|
UI Events # interface-mouseevent |
CSSOM View Module # extensions-to-the-mouseevent-interface |
Pointer Lock 2.0 # extensions-to-the-mouseevent-interface |
Совместимость с браузерами
BCD tables only load in the browser
Посмотрите также
- Its direct parent,
UIEvent
.