nwmatcher

WebJar for nwmatcher

License

License

MIT
GroupId

GroupId

org.webjars.npm
ArtifactId

ArtifactId

nwmatcher
Last Version

Last Version

1.4.4
Release Date

Release Date

Type

Type

jar
Description

Description

nwmatcher
WebJar for nwmatcher
Project URL

Project URL

http://webjars.org
Source Code Management

Source Code Management

https://github.com/dperini/nwmatcher

Download nwmatcher

How to add to project

<!-- https://jarcasting.com/artifacts/org.webjars.npm/nwmatcher/ -->
<dependency>
    <groupId>org.webjars.npm</groupId>
    <artifactId>nwmatcher</artifactId>
    <version>1.4.4</version>
</dependency>
// https://jarcasting.com/artifacts/org.webjars.npm/nwmatcher/
implementation 'org.webjars.npm:nwmatcher:1.4.4'
// https://jarcasting.com/artifacts/org.webjars.npm/nwmatcher/
implementation ("org.webjars.npm:nwmatcher:1.4.4")
'org.webjars.npm:nwmatcher:jar:1.4.4'
<dependency org="org.webjars.npm" name="nwmatcher" rev="1.4.4">
  <artifact name="nwmatcher" type="jar" />
</dependency>
@Grapes(
@Grab(group='org.webjars.npm', module='nwmatcher', version='1.4.4')
)
libraryDependencies += "org.webjars.npm" % "nwmatcher" % "1.4.4"
[org.webjars.npm/nwmatcher "1.4.4"]

Dependencies

There are no dependencies for this project. It is a standalone project that does not depend on any other jars.

Project Modules

There are no modules declared in this project.

NWMatcher

A fast CSS selector engine and matcher.

Installation

To include NWMatcher in a standard web page:

<script type="text/javascript" src="nwmatcher.js"></script>

To use it with Node.js:

$ npm install nwmatcher

NWMatcher currently supports browsers (as a global, NW.Dom) and headless environments (as a CommonJS module).

Supported Selectors

Here is a list of all the CSS2/CSS3 Supported selectors.

Features and Compliance

You can read more about NWMatcher features and compliance on the wiki.

API

DOM Selection

first( selector, context )

Returns a reference to the first element matching selector, starting at context.

match( element, selector, context )

Returns true if element matches selector, starting at context; returns false otherwise.

select( selector, context, callback )

Returns an array of all the elements matching selector, starting at context. If callback is provided, it is invoked for each matching element.

DOM Helpers

byId( id, from )

Returns a reference to the first element with ID id, optionally filtered to descendants of the element from.

byTag( tag, from )

Returns an array of elements having the specified tag name tag, optionally filtered to descendants of the element from.

byClass( class, from )

Returns an array of elements having the specified class name class, optionally filtered to descendants of the element from.

byName( name, from )

Returns an array of elements having the specified value name for their name attribute, optionally filtered to descendants of the element from.

getAttribute( element, attribute )

Return the value read from the attribute of element with name attribute, as a string.

hasAttribute( element, attribute )

Returns true element has an attribute with name attribute set; returns false otherwise.

Engine Configuration

configure( options )

The following is the list of currently available configuration options, their default values and descriptions, they are boolean flags that can be set to true or false:

  • CACHING: false - false to disable caching of result sets, true to enable
  • ESCAPECHR: true - true to allow CSS escaped identifiers, false to disallow
  • NON_ASCII: true - true to allow identifiers containing non-ASCII (utf-8) chars
  • SELECTOR3: true - switch syntax RE, true to use Level 3, false to use Level 2
  • UNICODE16: true - true to allow identifiers containing Unicode (utf-16) chars
  • SHORTCUTS: false - false to disable mangled selector strings like "+div" or "ul>"
  • SIMPLENOT: true - true to disallow complex selectors nested in ':not()' classes
  • SVG_LCASE: false - false to disable matching lowercase tag names of SVG elements
  • UNIQUE_ID: true - true to disallow multiple elements with the same id (strict)
  • USE_HTML5: true - true to use HTML5 specs for ":checked" and similar UI states
  • USE_QSAPI: true - true to use browsers native Query Selector API if available
  • VERBOSITY: true - true to throw exceptions, false to skip throwing exceptions
  • LOGERRORS: true - true to print console errors or warnings, false to mute them

Example:

NW.Dom.configure( { USE_QSAPI: false, VERBOSITY: false } );

registerOperator( symbol, resolver )

Registers a new symbol and its matching resolver in the operators table. Example:

NW.Dom.registerOperator( '!=', 'n!="%m"' );

registerSelector( name, rexp, func )

Registers a new selector, with the matching regular expression and the appropriate resolver function, in the selectors table.

Versions

Version
1.4.4
1.4.3
1.4.1
1.3.9
1.3.7
1.3.6