Next: Introduction, Previous: (dir), Up: (dir) [Contents][Index]
This is the css-selectors Reference Manual, generated automatically by Declt version 4.0 beta 2 "William Riker" on Thu Sep 15 04:31:41 2022 GMT+0.
Next: Systems, Previous: The css-selectors Reference Manual, Up: The css-selectors Reference Manual [Contents][Index]
CSS-selectors is a query language for finding specific nodes in dom documents and sub trees. CSS-selectors works with:
(query
(or css-selector-string match-fn)
(or nodes *document*))
Similar to jQuery('css-selector', NodeList or document)
Returns a list of matching nodes.
if the first argument is a css-selector string, compile it (as with compile-css-node-matcher) into a matcher function and call query again with it
if the first argument is a function, it is assumed to take a single node and to test whether or not that node matches the css-selector match function
If the css-selector-string is constantp, it will be compiled at compile time
The second argument is either a dom-node, a list of dom-nodes or the a dom document. It defaults to buildnode:document.
For full examples, please see the test suite, but a basic query call looks like:
(css-selectors:query "a" document)
which will return a list of all "a" tags in the document.
Exactly the same as (first (query ...)), except that it avoids
consing up an intermediate list.
(node-matches? node-node (or match-fn css-selector-string))
if the second argument is a css-selector, compile it (as with compile-css-node-matcher) into a matcher function and call node-matches again with it
if the second argument is a function, it is assumed to take a single node and to test whether or not that node matches the css-selector match function
If the css-selector-string is constantp, it will be compiled at compile time
(parse-results inp)
Parses a css3 selector into an AST representing the selector expression. Probably only useful for debugging or implementing a different compiler.
Uses clppcre and VERY basic flex parser (defined in parse.lisp) to create a lexer. Combines that lexer with a parser generated by cl-yacc and runs the input through the parse.
(compile-css-node-matcher inp)
Turns a parse-tree or css-selector-string into a compiled lambda matcher function this matcher function can be used with query and node-matches?. The matcher function takes two arguments
Any function defined in the :pseudo (:css-selectors.pseudo) will be available as a pseudo selector (see pseudo.lisp for examples).
All pseudo selectors should be of the following format: (defun pseudo:MY-NEW-PSEUDO (node &optional sub-sel-function) ...)
If your pseudo selector has no args, then it should signal an error if a sub-selction-function is passed to it and vice-versa
;; Copyright (c) 2011 Russ Tyndall , Acceleration.net http://www.acceleration.net
;; All rights reserved.
;;
;; Redistribution and use in source and binary forms, with or without
;; modification, are permitted provided that the following conditions are
;; met:
;;
;; - Redistributions of source code must retain the above copyright
;; notice, this list of conditions and the following disclaimer.
;;
;; - Redistributions in binary form must reproduce the above copyright
;; notice, this list of conditions and the following disclaimer in the
;; documentation and/or other materials provided with the distribution.
;;
;; THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
;; "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
;; LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
;; A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
;; OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
;; SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
;; LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
;; DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
;; THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
;; (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
;; OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
Next: Modules, Previous: Introduction, Up: The css-selectors Reference Manual [Contents][Index]
The main system appears first, followed by any subsystem dependency.
An implementation of css selectors
BSD
src (module).
Next: Files, Previous: Systems, Up: The css-selectors Reference Manual [Contents][Index]
Modules are listed depth-first from the system components tree.
css-selectors (system).
Next: Packages, Previous: Modules, Up: The css-selectors Reference Manual [Contents][Index]
Files are sorted by type and then listed depth-first from the systems components trees.
Next: css-selectors/src/packages.lisp, Previous: Lisp, Up: Lisp [Contents][Index]
css-selectors (system).
Next: css-selectors/src/node-api.lisp, Previous: css-selectors/css-selectors.asd, Up: Lisp [Contents][Index]
src (module).
Next: css-selectors/src/parse.lisp, Previous: css-selectors/src/packages.lisp, Up: Lisp [Contents][Index]
packages.lisp (file).
src (module).
Next: css-selectors/src/pseudo.lisp, Previous: css-selectors/src/node-api.lisp, Up: Lisp [Contents][Index]
node-api.lisp (file).
src (module).
parse-results (function).
Next: css-selectors/src/compile.lisp, Previous: css-selectors/src/parse.lisp, Up: Lisp [Contents][Index]
parse.lisp (file).
src (module).
Next: css-selectors/src/dom.lisp, Previous: css-selectors/src/pseudo.lisp, Up: Lisp [Contents][Index]
pseudo.lisp (file).
src (module).
Previous: css-selectors/src/compile.lisp, Up: Lisp [Contents][Index]
compile.lisp (file).
src (module).
Next: Definitions, Previous: Files, Up: The css-selectors Reference Manual [Contents][Index]
Packages are listed by definition order.
Next: css-selectors, Previous: Packages, Up: Packages [Contents][Index]
Next: css-selectors.pseudo, Previous: net.acceleration.css-selectors.system, Up: Packages [Contents][Index]
css
Previous: css-selectors, Up: Packages [Contents][Index]
pseudo
Next: Indexes, Previous: Packages, Up: The css-selectors Reference Manual [Contents][Index]
Definitions are sorted by export status, category, package, and then by lexicographic order.
Next: Internals, Previous: Definitions, Up: Definitions [Contents][Index]
Next: Ordinary functions, Previous: Public Interface, Up: Public Interface [Contents][Index]
Previous: Compiler macros, Up: Public Interface [Contents][Index]
Given a string, returns a matcher-function of a single node that will tell you whether or not the node matches
Given a node and a CSS selector, see if the given node matches that selector
Mostly used for debugging purposes
Takes a string CSS selector and turns it into an AST
Given a css selector, attempt to find the matching nodes in the passed in dom-trees (defaults to the document)
Given a css selector, attempt to find the first matching node in the passed in dom-trees (defaults to the document)
Previous: Public Interface, Up: Definitions [Contents][Index]
ignore tag name spaces when matching, for now the parser
doesnt support parsing namespaced tags, so lets ignore tag namespaces
Next: Ordinary functions, Previous: Special variables, Up: Internals [Contents][Index]
Next: Generic functions, Previous: Macros, Up: Internals [Contents][Index]
Expects a single matching group
readline that can read unix or dos lines
quotes in flex productions should be direct string matches
attrib-matcher
Returns a new string in which all the occurences of the part
is replaced with replacement. [FROM http://cl-cookbook.sourceforge.net/strings.html#manip]
trims the whitespace from a string returning nil
if trimming produces an empty string or the string ’nil’
Previous: Ordinary functions, Up: Internals [Contents][Index]
matches selector inp against the node
if first? is T then return the first matching node
Returns all child elements of this node
Returns all child nodes of this node
Returns the document of the given node
Is this an element
retrieves the value of a given attribute of the node
returns the parent element of this node
Returns all parent elements of this node
returns the parent node of this node
returns the parent element of this node
retrieves the name of the given element
Previous: Definitions, Up: The css-selectors Reference Manual [Contents][Index]
| Jump to: | %
A B C D E F G H I K L M N O P Q R S T U |
|---|
| Jump to: | %
A B C D E F G H I K L M N O P Q R S T U |
|---|
Next: Data types, Previous: Functions, Up: Indexes [Contents][Index]
| Jump to: | *
+
S |
|---|
| Jump to: | *
+
S |
|---|
| Jump to: | C D F M N P S |
|---|
| Jump to: | C D F M N P S |
|---|