GUACAMOLE-1204: Rename mouse-related classes to remove redundant "Mouse" prefix.

This commit is contained in:
Michael Jumper
2021-05-29 16:27:55 -07:00
parent 8d63277ba7
commit 0446433860

View File

@@ -40,13 +40,13 @@ var Guacamole = Guacamole || {};
* }); * });
* *
* @constructor * @constructor
* @augments Guacamole.Mouse.MouseEventTarget * @augments Guacamole.Mouse.Event.Target
* @param {Element} element * @param {Element} element
* The Element to use to provide mouse events. * The Element to use to provide mouse events.
*/ */
Guacamole.Mouse = function Mouse(element) { Guacamole.Mouse = function Mouse(element) {
Guacamole.Mouse.MouseEventTarget.call(this); Guacamole.Mouse.Event.Target.call(this);
/** /**
* Reference to this Guacamole.Mouse. * Reference to this Guacamole.Mouse.
@@ -499,7 +499,7 @@ Guacamole.Mouse.State.Buttons = {
* @param {Event|Event[]} [events=[]] * @param {Event|Event[]} [events=[]]
* The DOM events that are related to this event, if any. * The DOM events that are related to this event, if any.
*/ */
Guacamole.Mouse.MouseEvent = function MouseEvent(type, state, events) { Guacamole.Mouse.Event = function MouseEvent(type, state, events) {
Guacamole.Event.DOMEvent.call(this, type, events); Guacamole.Event.DOMEvent.call(this, type, events);
@@ -537,18 +537,18 @@ Guacamole.Mouse.MouseEvent = function MouseEvent(type, state, events) {
}; };
/** /**
* An object which can dispatch {@link Guacamole.Mouse.MouseEvent} objects * An object which can dispatch {@link Guacamole.Mouse.Event} objects
* representing mouse events. These mouse events may be produced from an actual * representing mouse events. These mouse events may be produced from an actual
* mouse device (as with {@link Guacamole.Mouse}), from an emulated mouse * mouse device (as with {@link Guacamole.Mouse}), from an emulated mouse
* device (as with {@link Guacamole.Mouse.Touchpad}, or may be programmatically * device (as with {@link Guacamole.Mouse.Touchpad}, or may be programmatically
* generated (using functions like [dispatch()]{@link Guacamole.Mouse.MouseEventTarget#dispatch}, * generated (using functions like [dispatch()]{@link Guacamole.Mouse.Event.Target#dispatch},
* [press()]{@link Guacamole.Mouse.MouseEventTarget#press}, and * [press()]{@link Guacamole.Mouse.Event.Target#press}, and
* [release()]{@link Guacamole.Mouse.MouseEventTarget#release}). * [release()]{@link Guacamole.Mouse.Event.Target#release}).
* *
* @constructor * @constructor
* @augments Guacamole.Event.Target * @augments Guacamole.Event.Target
*/ */
Guacamole.Mouse.MouseEventTarget = function MouseEventTarget() { Guacamole.Mouse.Event.Target = function MouseEventTarget() {
Guacamole.Event.Target.call(this); Guacamole.Event.Target.call(this);
@@ -567,12 +567,12 @@ Guacamole.Mouse.MouseEventTarget = function MouseEventTarget() {
* press ({@link Guacamole.Mouse}), an emulated mouse button press from a * press ({@link Guacamole.Mouse}), an emulated mouse button press from a
* touch gesture ({@link Guacamole.Mouse.Touchpad} and * touch gesture ({@link Guacamole.Mouse.Touchpad} and
* {@link Guacamole.Mouse.Touchscreen}), or may be programmatically * {@link Guacamole.Mouse.Touchscreen}), or may be programmatically
* generated through [dispatch()]{@link Guacamole.Mouse.MouseEventTarget#dispatch}, * generated through [dispatch()]{@link Guacamole.Mouse.Event.Target#dispatch},
* [press()]{@link Guacamole.Mouse.MouseEventTarget#press}, or * [press()]{@link Guacamole.Mouse.Event.Target#press}, or
* [click()]{@link Guacamole.Mouse.MouseEventTarget#click}. * [click()]{@link Guacamole.Mouse.Event.Target#click}.
* *
* @event Guacamole.Mouse.MouseEventTarget#mousedown * @event Guacamole.Mouse.Event.Target#mousedown
* @param {Guacamole.Mouse.MouseEvent} event * @param {Guacamole.Mouse.Event} event
* The mousedown event that was fired. * The mousedown event that was fired.
*/ */
@@ -582,12 +582,12 @@ Guacamole.Mouse.MouseEventTarget = function MouseEventTarget() {
* release ({@link Guacamole.Mouse}), an emulated mouse button release from * release ({@link Guacamole.Mouse}), an emulated mouse button release from
* a touch gesture ({@link Guacamole.Mouse.Touchpad} and * a touch gesture ({@link Guacamole.Mouse.Touchpad} and
* {@link Guacamole.Mouse.Touchscreen}), or may be programmatically * {@link Guacamole.Mouse.Touchscreen}), or may be programmatically
* generated through [dispatch()]{@link Guacamole.Mouse.MouseEventTarget#dispatch}, * generated through [dispatch()]{@link Guacamole.Mouse.Event.Target#dispatch},
* [release()]{@link Guacamole.Mouse.MouseEventTarget#release}, or * [release()]{@link Guacamole.Mouse.Event.Target#release}, or
* [click()]{@link Guacamole.Mouse.MouseEventTarget#click}. * [click()]{@link Guacamole.Mouse.Event.Target#click}.
* *
* @event Guacamole.Mouse.MouseEventTarget#mouseup * @event Guacamole.Mouse.Event.Target#mouseup
* @param {Guacamole.Mouse.MouseEvent} event * @param {Guacamole.Mouse.Event} event
* The mouseup event that was fired. * The mouseup event that was fired.
*/ */
@@ -597,11 +597,11 @@ Guacamole.Mouse.MouseEventTarget = function MouseEventTarget() {
* ({@link Guacamole.Mouse}), emulated mouse movement from * ({@link Guacamole.Mouse}), emulated mouse movement from
* a touch gesture ({@link Guacamole.Mouse.Touchpad} and * a touch gesture ({@link Guacamole.Mouse.Touchpad} and
* {@link Guacamole.Mouse.Touchscreen}), or may be programmatically * {@link Guacamole.Mouse.Touchscreen}), or may be programmatically
* generated through [dispatch()]{@link Guacamole.Mouse.MouseEventTarget#dispatch}, * generated through [dispatch()]{@link Guacamole.Mouse.Event.Target#dispatch},
* or [move()]{@link Guacamole.Mouse.MouseEventTarget#move}. * or [move()]{@link Guacamole.Mouse.Event.Target#move}.
* *
* @event Guacamole.Mouse.MouseEventTarget#mousemove * @event Guacamole.Mouse.Event.Target#mousemove
* @param {Guacamole.Mouse.MouseEvent} event * @param {Guacamole.Mouse.Event} event
* The mousemove event that was fired. * The mousemove event that was fired.
*/ */
@@ -610,11 +610,11 @@ Guacamole.Mouse.MouseEventTarget = function MouseEventTarget() {
* being monitored for interaction. This will only ever be automatically * being monitored for interaction. This will only ever be automatically
* fired due to movement of an actual mouse device via * fired due to movement of an actual mouse device via
* {@link Guacamole.Mouse} unless programmatically generated through * {@link Guacamole.Mouse} unless programmatically generated through
* [dispatch()]{@link Guacamole.Mouse.MouseEventTarget#dispatch}, * [dispatch()]{@link Guacamole.Mouse.Event.Target#dispatch},
* or [out()]{@link Guacamole.Mouse.MouseEventTarget#out}. * or [out()]{@link Guacamole.Mouse.Event.Target#out}.
* *
* @event Guacamole.Mouse.MouseEventTarget#mouseout * @event Guacamole.Mouse.Event.Target#mouseout
* @param {Guacamole.Mouse.MouseEvent} event * @param {Guacamole.Mouse.Event} event
* The mouseout event that was fired. * The mouseout event that was fired.
*/ */
@@ -624,7 +624,7 @@ Guacamole.Mouse.MouseEventTarget = function MouseEventTarget() {
* correspond to the button-related properties of * correspond to the button-related properties of
* {@link Guacamole.Mouse.State}. * {@link Guacamole.Mouse.State}.
* *
* @fires Guacamole.Mouse.MouseEventTarget#mousedown * @fires Guacamole.Mouse.Event.Target#mousedown
* *
* @param {String} button * @param {String} button
* The name of the mouse button to press, as defined by * The name of the mouse button to press, as defined by
@@ -636,7 +636,7 @@ Guacamole.Mouse.MouseEventTarget = function MouseEventTarget() {
this.press = function press(button, events) { this.press = function press(button, events) {
if (!this.currentState[button]) { if (!this.currentState[button]) {
this.currentState[button] = true; this.currentState[button] = true;
this.dispatch(new Guacamole.Mouse.MouseEvent('mousedown', this.currentState, events)); this.dispatch(new Guacamole.Mouse.Event('mousedown', this.currentState, events));
} }
}; };
@@ -646,7 +646,7 @@ Guacamole.Mouse.MouseEventTarget = function MouseEventTarget() {
* correspond to the button-related properties of * correspond to the button-related properties of
* {@link Guacamole.Mouse.State}. * {@link Guacamole.Mouse.State}.
* *
* @fires Guacamole.Mouse.MouseEventTarget#mouseup * @fires Guacamole.Mouse.Event.Target#mouseup
* *
* @param {String} button * @param {String} button
* The name of the mouse button to release, as defined by * The name of the mouse button to release, as defined by
@@ -658,7 +658,7 @@ Guacamole.Mouse.MouseEventTarget = function MouseEventTarget() {
this.release = function release(button, events) { this.release = function release(button, events) {
if (this.currentState[button]) { if (this.currentState[button]) {
this.currentState[button] = false; this.currentState[button] = false;
this.dispatch(new Guacamole.Mouse.MouseEvent('mouseup', this.currentState, events)); this.dispatch(new Guacamole.Mouse.Event('mouseup', this.currentState, events));
} }
}; };
@@ -668,8 +668,8 @@ Guacamole.Mouse.MouseEventTarget = function MouseEventTarget() {
* correspond to the button-related properties of * correspond to the button-related properties of
* {@link Guacamole.Mouse.State}. * {@link Guacamole.Mouse.State}.
* *
* @fires Guacamole.Mouse.MouseEventTarget#mousedown * @fires Guacamole.Mouse.Event.Target#mousedown
* @fires Guacamole.Mouse.MouseEventTarget#mouseup * @fires Guacamole.Mouse.Event.Target#mouseup
* *
* @param {String} button * @param {String} button
* The name of the mouse button to click, as defined by * The name of the mouse button to click, as defined by
@@ -686,7 +686,7 @@ Guacamole.Mouse.MouseEventTarget = function MouseEventTarget() {
/** /**
* Moves the mouse to the given coordinates. * Moves the mouse to the given coordinates.
* *
* @fires Guacamole.Mouse.MouseEventTarget#mousemove * @fires Guacamole.Mouse.Event.Target#mousemove
* *
* @param {Guacamole.Position|Object} position * @param {Guacamole.Position|Object} position
* The new coordinates of the mouse pointer. This object may be a * The new coordinates of the mouse pointer. This object may be a
@@ -701,7 +701,7 @@ Guacamole.Mouse.MouseEventTarget = function MouseEventTarget() {
if (this.currentState.x !== position.x || this.currentState.y !== position.y) { if (this.currentState.x !== position.x || this.currentState.y !== position.y) {
this.currentState.x = position.x; this.currentState.x = position.x;
this.currentState.y = position.y; this.currentState.y = position.y;
this.dispatch(new Guacamole.Mouse.MouseEvent('mousemove', this.currentState, events)); this.dispatch(new Guacamole.Mouse.Event('mousemove', this.currentState, events));
} }
}; };
@@ -710,21 +710,21 @@ Guacamole.Mouse.MouseEventTarget = function MouseEventTarget() {
* Notifies event listeners that the mouse pointer has left the boundaries * Notifies event listeners that the mouse pointer has left the boundaries
* of the area being monitored for mouse events. * of the area being monitored for mouse events.
* *
* @fires Guacamole.Mouse.MouseEventTarget#mouseout * @fires Guacamole.Mouse.Event.Target#mouseout
* *
* @param {Event|Event[]} [events=[]] * @param {Event|Event[]} [events=[]]
* The DOM events related to the mouse leaving the boundaries of the * The DOM events related to the mouse leaving the boundaries of the
* monitored object, if any. * monitored object, if any.
*/ */
this.out = function out(events) { this.out = function out(events) {
this.dispatch(new Guacamole.Mouse.MouseEvent('mouseout', this.currentState, events)); this.dispatch(new Guacamole.Mouse.Event('mouseout', this.currentState, events));
}; };
/** /**
* Releases all mouse buttons that are currently pressed. If all mouse * Releases all mouse buttons that are currently pressed. If all mouse
* buttons have already been released, this function has no effect. * buttons have already been released, this function has no effect.
* *
* @fires Guacamole.Mouse.MouseEventTarget#mouseup * @fires Guacamole.Mouse.Event.Target#mouseup
* *
* @param {Event|Event[]} [events=[]] * @param {Event|Event[]} [events=[]]
* The DOM event related to all mouse buttons being released, if any. * The DOM event related to all mouse buttons being released, if any.
@@ -760,13 +760,13 @@ Guacamole.Mouse.MouseEventTarget = function MouseEventTarget() {
* }); * });
* *
* @constructor * @constructor
* @augments Guacamole.Mouse.MouseEventTarget * @augments Guacamole.Mouse.Event.Target
* @param {Element} element * @param {Element} element
* The Element to use to provide touch events. * The Element to use to provide touch events.
*/ */
Guacamole.Mouse.Touchpad = function Touchpad(element) { Guacamole.Mouse.Touchpad = function Touchpad(element) {
Guacamole.Mouse.MouseEventTarget.call(this); Guacamole.Mouse.Event.Target.call(this);
/** /**
* The "mouseout" event will never be fired by Guacamole.Mouse.Touchpad. * The "mouseout" event will never be fired by Guacamole.Mouse.Touchpad.
@@ -998,13 +998,13 @@ Guacamole.Mouse.Touchpad = function Touchpad(element) {
* }); * });
* *
* @constructor * @constructor
* @augments Guacamole.Mouse.MouseEventTarget * @augments Guacamole.Mouse.Event.Target
* @param {Element} element * @param {Element} element
* The Element to use to provide touch events. * The Element to use to provide touch events.
*/ */
Guacamole.Mouse.Touchscreen = function Touchscreen(element) { Guacamole.Mouse.Touchscreen = function Touchscreen(element) {
Guacamole.Mouse.MouseEventTarget.call(this); Guacamole.Mouse.Event.Target.call(this);
/** /**
* The "mouseout" event will never be fired by Guacamole.Mouse.Touchscreen. * The "mouseout" event will never be fired by Guacamole.Mouse.Touchscreen.