CSS: escape() 静的メソッド

Baseline 広く利用可能

この機能は広く実装されており、多くのバージョンの端末やブラウザーで動作します。2020年1月以降、すべてのブラウザーで利用可能です。

もっと詳しく
完全な互換性情報を見る

CSS.escape() は静的メソッドで、 CSS セレクターの一部として使用するために引数として渡されるエスケープ処理された文字列の入った文字列を返します。

構文

CSS.escape(str)

引数

str: エスケープ処理する文字列です。

返値

エスケープされた文字列です。

例

基本的な結果

CSS.escape(".foo#bar"); // "\\.foo\\#bar"
CSS.escape("()[]{}"); // "\\(\\)\\[\\]\\{\\}"
CSS.escape('--a'); // "--a"
CSS.escape(0); // "\30円 " ('0' の Unicode コードポイントは 30)
CSS.escape('0円'); // "\ufffd" (Unicode REPLACEMENT CHARACTER)

コンテキスト内での使用

セレクターの一部として使用するために文字列をエスケープするには、 escape() メソッドを使用します。

const element = document.querySelector(`#${CSS.escape(id)} > img`);

escape() メソッドは文字列のエスケープにも使えますが、厳密にはエスケープする必要がない文字もエスケープしてしまいます。

const element = document.querySelector(`a[href="#${CSS.escape(fragment)}"]`);

仕様書

仕様書
CSS Object Model (CSSOM) # the-css.escape()-method

ブラウザーの互換性

MDN の改良に協力

協力方法を知る

このページは MDN の貢献者によって 2026年2月15日に最終更新されました。

GitHub でこのページを表示 • このコンテンツに関する問題を報告