Slick is a standalone selector engine that is totally slick. Slick is split in 2 components: the Finder and the Parser. The Finder's job is to find nodes on a webpage, the Parser's job is to create a javascript object representation of any css selector.

Slick allows you to:

Create your own custom pseudo-classes
Use the Parser by itself.
Find nodes in XML documents.

The Finder

Find nodes in the DOM

`search` context for selector

Search this context for any nodes that match this selector.

Expects:

selector: String or SelectorObject
(optional) context: document or node or array of documents or nodes
(optional) append: Array or Object with a push method

Returns: append argument or Array of 0 or more nodes

slick.search("#foo > bar.baz") → [<bar>, <bar>, <bar>]
slick.search("li > a", [<ol>, <ul>]) → [<a>, <a>, <a>]
slick.search("#foo > bar.baz", document, []) → [<bar>, <bar>, <bar>]

`find` first in context with selector or null

Find the first node in document that matches selector or null if none are found.

Expects:

selector: String or SelectorObject
(optional) context: document or node or array of documents or nodes

Returns: Element or null

slick.find("#foo > bar.baz") → <bar>
slick.find("#does-not-exist", node) → null

node `matches` selector?

Does this node match this selector?

Expects:

node
node, String or SelectorObject

Returns: true or false

slick.matches(<div class=rocks>, "div.rocks") → true
slick.matches(<div class=lame>, "div.rocks") → false
slick.matches(<div class=lame>, <div class=rocks>) → false

context `contains` node?

Does this context contain this node? Is the context a parent of this node?

Expects:

context: document or node
node: node

Returns: true or false

slick.contains(<ul>, <li>) → true
slick.contains(<body>, <html>) → false

The Parser

Parse a CSS selector string into a JavaScript object

`parse` selector into object

Parse a CSS Selector String into a Selector Object.

Expects: String

Returns: SelectorObject

slick.parse("#foo > bar.baz") → SelectorObject

format

`#foo > bar.baz`

[[
	{ "combinator":" ", "tag":"*", "id":"foo" },
	{ "combinator":">", "tag":"bar", "classList": ["baz"], "classes": [{"value":"baz", "match": RegExp }]}
]]

`h1, h2, ul > li, .things`

[
	[{ "combinator":" ", "tag": "h1" }],
	[{ "combinator":" ", "tag": "h2" }],
	[{ "combinator":" ", "tag": "ul" }, { "combinator": ">", "tag": "li" }],
	[{ "combinator":" ", "tag": "*", "classList": ["things"], "classes": [{"value": "things", "match": RegExp }] }]
]

Keywords

FAQs

What is slick?

Is slick popular?

Is slick well maintained?

Package last updated on 03 May 2015

Did you know?

Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.

Install

slick

Slick

The Finder

find first in context with selector or null

node matches selector?

context contains node?

The Parser

parse selector into object

format

#foo > bar.baz

h1, h2, ul > li, .things

Keywords

Related posts

The Wildcard Gamble: Understanding the Risks of Floating Dependency Ranges in npm

New Rust RFC Proposes Adding Support for Trusted Publishing to Crates.io

`find` first in context with selector or null

node `matches` selector?

context `contains` node?

`parse` selector into object

`#foo > bar.baz`

`h1, h2, ul > li, .things`