CSSのpointer-eventsで、下の要素にクリックを通す方法

​​CSS​JavaScript

重ねた要素に pointer-events: none を付けると、クリックはその要素を素通りして、下にあるボタンやリンクに届きます。画像やカードの上に置いた透かし(ウォーターマーク)やグラデーションの影、画面全体を覆う通知(トースト)の層のせいで、下のボタンが押せなくなったときに使う指定です。ホバーやマウスホイールも下の要素に届き、子要素に pointer-events: auto を付ければ、その子だけは押せるようにできます。

補足

検証環境は Ubuntu 24.04、Node.js 22.23.4、Playwright 1.63.0、ヘッドレスの Chromium 153 です。検証用のページを Playwright で開き、page.mouse でクリック、ホバー、ホイールを送って、どの要素のイベントリスナーが動いたかを記録しました。Firefox と Safari、タッチ操作は試していません。SVG 専用の値(visiblePainted など)は扱いません。

重ねた要素に pointer-events: none を付ける

ボタンを含むカードの上に、斜めの縞模様の層を position: absolute で全面に重ね、ボタンの中央をクリックしました。

css
.card {
  position: relative;
}

.layer {
  position: absolute;
  inset: 0;
  pointer-events: none; /* クリックを下の要素に通す */
}
上下2段の比較。上の「指定なし:クリックは重ねた層が受ける」では、縞模様の層が重なったカードの「お知らせを見る」ボタンの中央にピンクの丸があり、下に「ボタンのクリック回数:0回」とある。下の「層に pointer-events: none:下のボタンに届く」では、同じ位置にピンクの丸があり、「ボタンのクリック回数:1回」の数字がピンクになっている
ピンクの丸の位置をクリックしたあと。層に pointer-events: none を付けると、ボタンのクリック回数が増える

指定がないと、クリックを受けたのは上に重ねた層で、ボタンのクリック回数は 0 回のままでした。層に pointer-events: none を付けると、同じ位置のクリックでボタンの click イベントが動き、回数が 1 回になりました。

画像とは別に、ボタンの上に透明から白へのグラデーションの層を全面に重ねたページでも調べました。ボタンの中央の座標を document.elementFromPoint() で調べると、どの要素がクリックを受けるかが分かります。指定がないときは重ねた層が、pointer-events: none を付けたときはボタンが返りました。下の要素が押せないときに、何が上に重なっているのかを探すのにも使えます。

MDN の pointer-events のページでは、none の要素はポインターイベントの対象にならず、イベントは要素を「通過」して下の要素に届くと説明されています。

ホバーとマウスホイールも下に届く

pointer-events: none で下に届くのは、クリックだけではありません。同じグラデーションの層のページで、ボタンに :hover で背景色を変える指定をして、層の上からマウスを乗せると、指定がない層ではボタンの背景色は変わらず、none を付けた層ではボタンの背景色が :hover の色になりました。

マウスホイールも同じでした。overflow: auto でスクロールする箱の下端に、グラデーションの影を兄弟要素として重ね、影の上でホイールを 100px 分回しました。影に指定がないと箱は動かず(scrollTop が 0)、pointer-events: none を付けると箱が 100px スクロールしました。スクロールする箱の上に飾りを重ねるときは、クリックだけでなくスクロールのためにも付けておく指定です。

子だけを押せるようにする

画面の右下に通知を出すために、画面全体を覆う position: fixed の層を作る場合があります。層に pointer-events: none を付け、通知の部分にだけ pointer-events: auto を付けると、通知の外では下のページを操作でき、通知の中のボタンも押せます。

css
.toast-layer {
  position: fixed;
  inset: 0;
  pointer-events: none;
}

.toast {
  position: absolute;
  right: 16px;
  bottom: 16px;
  pointer-events: auto; /* 通知の中だけは押せるようにする */
}

このページで試した結果は次のとおりです。

クリックした位置 クリックを受けた要素
層の下にあるページのボタン ページのボタン
層の中の、指定のない子(文字) 子を素通りして、下の body
通知の中の「閉じる」ボタン 「閉じる」ボタン
通知の中の文字 通知の中の文字の要素

pointer-events は継承するプロパティです(CSS Basic User Interface Module Level 4 の仕様)。層の中で何も指定しない子の計算値は none になり、その子もクリックを素通りさせました。通知の要素に auto を付けると、その中の「閉じる」ボタンの計算値も auto になりました。押せるようにしたい部分のいちばん外側に auto を付ければ、中身にまとめて効きます。

ポイント

pointer-events: none を付けた層のリスナーが、まったく動かなくなるわけではありません。層に付けた click のリスナーは、通知の中の「閉じる」ボタンや文字をクリックしたときに動き、event.target はクリックした子でした。子の click イベントが、バブリングで層まで上がってきたためです。

MDN のページと仕様にも、none の要素の子孫が auto などの別の値を持てば、その子孫はイベントの対象になり、イベントはキャプチャやバブリングで none の祖先のリスナーにも届くとあります。一方、層の中で通知の外をクリックしたときは、層のリスナーは動きませんでした。クリックは層を素通りして、下の body に届いています。

キーボードの操作は止まらない

pointer-events: none を付けても、キーボードの操作は止まりません。href="#done" のリンクに pointer-events: none を付けて試しました。

  • マウスでクリックすると、location.hash は空のままで、リンク先へは移りませんでした。
  • Tab キーを押すと、リンクにフォーカスが移りました。
  • そのまま Enter キーを押すと、location.hash が #done になり、リンク先へ移りました。

MDN のページと仕様にも、pointer-events: none の要素は Tab キーによるフォーカスの移動を止めないとあります。

押せないボタンを作りたいときは、pointer-events: none ではなく、HTML の disabled 属性を付けます。disabled のボタンは、マウスでクリックしても click のリスナーが動かず、Tab キーを押すとフォーカスはそのボタンを飛ばして次のボタンに移りました。

​Posted by 86