Sass Selector Functions
Sass Selector Functions
The selector functions are used to check and manipulate selectors.
The following table lists all selector functions in Sass:
| Function | Description & Example |
|---|---|
| is-superselector(super, sub) | Checks whether the super selector matches all the elements that sub matches. Example: is-superselector("div", "div.myInput") Result: true is-superselector("div.myInput", "div") Result: false is-superselector("div", "div") Result: true |
| selector-append(selectors) | Appends the second (and third/fourth etc.) selector to the first selector. Example: selector-append("div", ".myInput") Result: div.myInput selector-append(".warning", "__a") Result: .warning__a |
| selector-extend(selector, extendee, extender) | |
| selector-nest(selectors) | Returns a new selector containing a nested list of CSS selectors based on the list provided. Example: selector-nest("ul", "li") Result: ul li selector-nest(".warning", "alert", "div") Result: .warning div, alert div |
| selector-parse(selector) | Returns a list of strings contained in selector using the same format as the parent selector. Example: selector-parse("h1 .myInput .warning") Result: ('h1' '.myInput' '.warning') |
| selector-replace(selector, original, replacement) | Returns a new selector with the selectors specified in replacement in place of selectors specified in original. Example: selector-replace("p.warning", "p", "div") Result: div.warning |
| selector-unify(selector1, selector2) | Returns a new selector that matches only elements matched by both selector1 and selector2. Example: selector-unify("myInput", ".disabled") Result: myInput.disabled selector-unify("p", "h1") Result: null |
| simple-selectors(selectors) | Returns a list of the individual selectors in selectors. Example: simple-selectors("div.myInput") Result: div, .myInput simple-selectors("div.myInput:before") Result: div, .myInput, :before |
