npm

Need private packages and team management tools?Check out npm Orgs. »

posthtml-match-helper

1.0.1 • Public • Published

posthtml-match-helper

A helper to expand CSS selectors into PostHTML matcher objects

Using the helper function supplied by this module you can turn simple CSS selectors into match objects that posthtml match accepts.

Supported features:

  • Tags: "div" returns {tag: "div"}.
  • Ids: "#bar" returns {attrs: {id: "bar"}}.
  • Classes: .foo returns {attrs: { class: /(?:^|\s)foo(?:\\s|$)/ }}. Any number of classnames supported.
  • Attribute selectors: Any number of the standard attribute selectors can be used1 including the following non-standard:
    • [attr!=value]: Matches if the attr attribute value does not contain the value.
  • Multiple node selectors: "div, section" returns [{tag: "div"}, {tag: "span"}].

1 Multiple attribute selectors for the same attribute are not supported (this includes mixing classnames and attribute selectors matching class).

The basic template for selectors (and order of features) looks like this:

"tag#id.class.name[attr*=value][otherattr^='start']"

Basic usage

var matchHelper = require("posthtml-match-helper");
 
tree.match(matchHelper("div.class"), function (node) {
    // do stuff with matched node...
});

Advanced usage

var matchHelper = require("posthtml-match-helper");
 
tree.match(matchHelper("input.my-control[type!='radio'][checked], input[value^='foo'][checked]"), function (node) {
    // do stuff with node that matched either of the selectors...
});

The helper function

Arguments

  • matcher (string) - A CSS selector that describes the node you want to match in PostHTML.

Returns

A matcher object - or array of matcher objects.

install

npm i posthtml-match-helper

Downloadsweekly downloads

3,865

version

1.0.1

license

ISC

homepage

github.com

repository

Gitgithub

last publish

collaborators

  • avatar
Report a vulnerability