CKTIS / JavaScript
MouseEvent.clientY — verticale viewportcoördinaat
MouseEvent.clientY is een alleen-lezen eigenschap die de verticale coördinaat van een muisgebeurtenis ten opzichte van de viewport geeft. De eigenschap beschrijft geen positie ten opzichte van het doelelement of het fysieke scherm.
Versie: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntax
event.clientYMouseEvent.clientY geeft de verticale coördinaat aan van de plek waar een gebeurtenis plaatsvond, ten opzichte van de viewport die bij die gebeurtenis hoort. Je leest de waarde uit als event.clientY, bijvoorbeeld bij het afhandelen van mousemove of click. Het is een alleen-lezen eigenschap.
De viewport is het referentiekader, niet het element waarop de gebeurtenis gericht is. Verwar de eigenschap niet met clientX, dat de horizontale positie beschrijft, of met screenY, waarvan het scherm het referentiekader is. Controleer bij het interpreteren van coördinaten altijd het referentiekader.
Het voorbeeld maakt een synthetische gebeurtenis met clientY: 120 en een tweede zonder expliciete coördinaat. De constructor initialiseert de eigenschap; je kent er na het maken van het object geen waarde aan toe. Als clientY ontbreekt, is de standaardwaarde 0. Door de gebeurtenis te maken, beweegt de echte muisaanwijzer niet.
Voer het voorbeeld uit in de browserconsole. De verwachte resultaten zijn achtereenvolgens 120 en 0. Dit is een Web-API, geen functie van ECMAScript zelf; de aanwezigheid van Node 24 in een repository bewijst niet dat MouseEvent in die omgeving beschikbaar is.
Voorbeelden
const event = new MouseEvent("mousemove", { clientY: 120 });
const defaultEvent = new MouseEvent("mousemove");
console.log(event.clientY);
console.log(defaultEvent.clientY);Resultaat
120 0
De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.