style-search

WebJar for style-search

License

License

ISC
Categories

Categories

Search Business Logic Libraries
GroupId

GroupId

org.webjars.npm
ArtifactId

ArtifactId

style-search
Last Version

Last Version

0.1.0
Release Date

Release Date

Type

Type

jar
Description

Description

style-search
WebJar for style-search
Project URL

Project URL

http://webjars.org
Source Code Management

Source Code Management

https://github.com/davidtheclark/style-search

Download style-search

How to add to project

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

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.

style-search CircleCI

Search CSS (and CSS-like) strings, with sensitivity to whether matches occur inside strings, comments, and functions.

Usage

var styleSearch = require('style-search');

styleSearch(options, callback);

By default, the search ignores strings, comments, and function names. You can use the options to change this behavior or introduce other restrictions. That is what makes this module more useful for many searches than indexOf() or a RegExp.

However, if you need more detailed parsing, you should consider using the real parsers PostCSS, postcss-selector-parser, and postcss-value-parser.

Example

/* Here is some pink */
a { color: pink; }
a::before { content: "pink" }
b { color: shadesOfPink(7); }
styleSearch({
  source: theCssStringAbove,
  target: "pink",
}, function(match, count) {
  /* Only the "pink" in `color: pink` will be
  reported as a match */
});

Reporting matches

For every match found your callback is invoked. It is passed two arguments:

  • A match object with the following properties:
    • startIndex: where the match begins
    • endIndex: where the match ends
    • target: what got matched (useful if your target option is an array instead of a single string)
    • insideFunctionArguments: whether the match is inside a function — this includes the parentheses around the arguments
    • insideComment: whether the match is inside a comment
    • insideString: whether the match is inside a string
  • The count of how many matches have been found up to this point.

Options

Below you'll see that syntax feature options all accept three keywords: "skip", "check", "only". An error will be thrown if you use "only" more than once.

source

String. Required.

The source string to search through.

target

String or array of strings. Required.

The target of the search. Can be

  • a single character
  • a string with some length
  • an array of strings, all of which count as matches (the match object passed to the callback will differentiate which string in the array got matched via its target property)

once

Boolean. Default: false.

If true, the search will stop after one match is found.

comments

"skip" | "check" | "only". Default: "skip".

This includes both standard /* CSS comments */ and non-standard but widely used // single line comments.

strings

"skip" | "check" | "only". Default: "skip".

functionNames

"skip" | "check" | "only". Default: "skip".

functionArguments

"skip" | "check" | "only". Default: "check".

parentheticals

"skip" | "check" | "only". Default: "check".

This designates anything inside parentheses, which includes standard functions, but also Sass maps and other non-standard constructs. parentheticals is a broader category than functionArguments.

Versions

Version
0.1.0