HTMLElement: inert プロパティ
Baseline
広く利用可能
*
この機能は広く実装されており、多くのバージョンの端末やブラウザーで動作します。2023年4月以降、すべてのブラウザーで利用可能です。
* この機能の一部は、対応レベルにばらつきがある場合があります。
HTMLElement の inert プロパティは、この要素の inert 属性の値を反映します。これは論理値です。属性が存在する場合、ブラウザーはフォーカスイベントや支援技術からのイベントなど、この要素に対するユーザーの入力イベントを「無視」します。ブラウザーは、この要素でのページ検索やテキスト選択も無視することがあります。これは、モーダルのような UI を構築する際、モーダルの表示中にフォーカスをモーダル内に「閉じ込める」場合に便利です。
なお、inert 属性が指定されていない場合でも、要素自体は親要素から不活性状態を継承することがあります。ただし、この継承された不活性状態は、このプロパティの値には反映されません。プロパティを明示的に false に設定しても、親要素から継承した不活性状態を解除することはできません。
値
論理値で、その要素が不活性である場合は true、それ以外の場合はこの値は false になります。
例
>HTML
html
<div>
<label for="button1">ボタン 1</label>
<button id="button1">不活性ではありません</button>
</div>
<div inert>
<label for="button2">ボタン 2</label>
<button id="button2">不活性です</button>
</div>
CSS
css
[inert] > * {
opacity: 0.5;
}
結果
メモ:
この属性だけでは、ブラウザーに表示されるコンテンツに視覚的な変化は起こりません。上の例では、inert 属性を持つ要素の直系の子孫が半透明で表示されるように CSS が適用されています。
仕様書
| 仕様書 |
|---|
| HTML> # dom-inert> |
ブラウザーの互換性
関連情報
- グローバル属性:
inert disabled<dialog>- CSS の
interactivityプロパティ