CSS.escape()
Experimental: This is an experimental technology
Check the Browser compatibility table carefully before using this in production.
The CSS.escape()
static method returns a
CSSOMString
containing the escaped string passed as parameter, mostly for
use as part of a CSS selector.
Syntax
escapedStr = CSS.escape(str);
Parameters
- str
-
The
CSSOMString
to be escaped.
Examples
Basic results
CSS.escape(".foo#bar") // "\.foo\#bar"
CSS.escape("()[]{}") // "\(\)\[\]\{\}"
CSS.escape('--a') // "--a"
CSS.escape(0) // "\30 ", the Unicode code point of '0' is 30
CSS.escape('\0') // "\ufffd", the Unicode REPLACEMENT CHARACTER
In context uses
To escape a string for use as part of a selector, the escape()
method can
be used:
var element = document.querySelector('#' + CSS.escape(id) + ' > img');
The escape()
method can also be used for escaping strings, although it
escapes characters that don't strictly need to be escaped:
var element = document.querySelector('a[href="#' + CSS.escape(fragment) + '"]');
Specifications
Specification |
---|
CSS Object Model (CSSOM) # the-css.escape()-method |
Browser compatibility
BCD tables only load in the browser
See also
- The
CSS
interface where this static method resides. - A polyfill for the CSS.escape