GlobalEventHandlers.onclick
The onclick property of the
GlobalEventHandlers mixin is the event handler for
processing click events on a given element.
The click event is raised when the user clicks on an element. It fires
after the mousedown and
mouseup events, in that order.
Note: When using the click event to
trigger an action, also consider adding this same action to the
keydown event, to allow the use of that same
action by people who don't use a mouse or a touch screen.
Syntax
target.onclick = functionRef;
Value
functionRef is a function name or a function
expression. The function receives a MouseEvent object as its sole
argument. Within the function, this will be the object
that onclick was bound to (which will also match
event.currentTarget)
Only one onclick handler can be assigned to an object at a time. You may
prefer to use the EventTarget.addEventListener() method instead, since
it's more flexible.
Examples
Detecting clicks
This example changes the color of an element when it's clicked upon.
HTML
<div id="demo">Click here</div>
JavaScript
document.getElementById('demo').onclick = function changeContent() {
document.getElementById('demo').textContent = "Help me";
document.getElementById('demo').style = "Color: red";
}
Result
Getting the coordinates of clicks
This example displays the coordinates at which the most recent mouse button click occurred.
HTML
<p>Click anywhere in this example.</p>
<p id="log"></p>
JavaScript
let log = document.getElementById('log');
document.onclick = inputChange;
function inputChange(e) {
log.textContent = `Position: (${e.clientX}, ${e.clientY})`;
}
Result
Specifications
| Specification |
|---|
| HTML Standard # handler-onclick |
Browser compatibility
BCD tables only load in the browser
See also
clickevent- Related event handlers