Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / CSS

Propriété CSS `pointer-events`

`pointer-events` détermine si les boîtes d’un élément participent au test de pointage : `auto` conserve le ciblage normal, tandis que `none` permet à l’élément situé dessous de devenir la cible.

Version : CSS modules; structured CSSWG indexes reconciled with pinned MDN BCD; Chromium 152 scope gate, per-example verification still required

Syntaxe

auto | none

pointer-events détermine si les boîtes d’un élément participent au test de pointage : auto conserve le ciblage normal, tandis que none permet à l’élément situé dessous de devenir la cible.

L’exemple superpose au bouton une couche transparente avec none, si bien que le premier point atteint le bouton inférieur ; un enfant de cette couche doté de son propre auto redevient ciblable et son événement remonte à travers le parent.

Grammaire: auto | none.

La propriété est héritée : un descendant doit donc définir explicitement auto pour rétablir le test sous un parent en none. L’exclusion du test ne retire pas l’élément de la navigation séquentielle au clavier, et un écouteur ancêtre peut encore recevoir un événement visant un descendant actif.

Exemples

<!doctype html><meta charset="utf-8"><style>html,body{margin:0}.zone{position:absolute;top:0;width:100px;height:80px}.under{position:absolute;inset:0}.cover{position:absolute;inset:0;pointer-events:none}.cover button{position:absolute;left:20px;top:40px;width:60px;height:30px;pointer-events:auto}</style><div class="zone" style="left:0"><button id="under" class="under">under</button><div id="cover" class="cover"><button id="child">child</button></div></div><pre id="result"></pre><script>let clicked=[],bubbled=0;under.onclick=()=>clicked.push('under');child.onclick=()=>clicked.push('child');cover.addEventListener('click',()=>bubbled++);const hit1=document.elementFromPoint(10,10),hit2=document.elementFromPoint(50,55);hit1.click();hit2.click();const a=getComputedStyle(cover).pointerEvents,b=getComputedStyle(child).pointerEvents;if(hit1.id!=='under'||hit2.id!=='child'||clicked.join('/')!=='under/child'||bubbled!==1||a!=='none'||b!=='auto')throw new Error('pointer hit-test mismatch');result.textContent='hits='+hit1.id+'/'+hit2.id+'; clicks='+clicked.join('/')+'; bubbled='+bubbled+'; computed='+a+'/'+b;</script>

Résultat

hits=under/child; clicks=under/child; bubbled=1; computed=none/auto

L’exemple superpose au bouton une couche transparente avec `none`, si bien que le premier point atteint le bouton inférieur ; un enfant de cette couche doté de son propre `auto` redevient ciblable et son événement remonte à travers le parent.

Sources