Selector lite –

DEPRECATED! It is merged into dom-lite. Use require('dom-lite/selector')

A small pure-JavaScript CSS selector engine.

• no library dependencies
• CSS 3 Selector support
• only 2KB minified and 1KB gzipped

Examples

1var selector = require("selector-lite")
2
3// Can be used to implement browser built-in functions.
4
5function getElementById(id) {
6    return selector.find(this, "#" + id, true)
7}
8function getElementsByTagName(tag) {
9    return selector.find(this, tag)
10}
11function getElementsByClassName(sel) {
12    return selector.find(this, "." + sel.replace(/\s+/g, "."))
13}
14function querySelector(sel) {
15    return selector.find(this, sel, true)
16}
17function querySelectorAll(sel) {
18    return selector.find(this, sel)
19}

Methods

• selector.find(node, selector, returnFirstMatch) - Find matching elements like querySelector.
• selector.matches(node, selector) - Returns a Boolean indicating whether or not the element would be selected by the specified selector string.
• selector.closest(selector) - Returns the Element, descendant of this element (or this element itself), that is the closest ancestor of the elements selected by the selectors given in parameter.
• selector.next(selector) - Retrieves the next sibling that matches selector.
• selector.prev(selector) - Retrieves the preceding sibling that matches selector.

Custom selectors

Custom selector can be added to selector.selectorMap, where method shortcuts are available (m->matches, c->closest, n->next, p->prev).

• _ - node.
• v - part between () in :nth-child(2n+1).
• a and b can be used as temp variables.

1// Add `:input` selector
2selector.selectorMap.input = "_.tagName=='INPUT'"
3
4// Add `:val()` selector
5selector.selectorMap.val = "_.value==v"

Contributing

Follow Coding Style Guidelines

Run tests

npm install
npm test

External links

GitHub repo | npm package | DOM spec | Selectors Level 3 | Coveralls coverage
Buy Me A Tea

Licence

Copyright (c) 2015-2021 Lauri Rooden <lauri@rooden.ee>
The MIT License