Skip to content

Files

Latest commit

Sep 11, 2021
ff979aa · Sep 11, 2021

History

History

slick

Folders and files

NameName
Last commit message
Last commit date

parent directory

..
Sep 11, 2021
Sep 11, 2021
Sep 11, 2021
Sep 11, 2021
Sep 11, 2021
Sep 11, 2021

Slick

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 }] }]
]