No Packages Misplaced

    posthtml-match-helper
    TypeScript icon, indicating that this package has built-in type declarations

    1.0.3 • 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, span" 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

    32,605

    Version

    1.0.3

    License

    ISC

    Unpacked Size

    5.46 kB

    Total Files

    4

    Last publish

    Collaborators

    • phloe