1
0
mirror of https://github.com/thangisme/notes.git synced 2024-11-01 08:17:34 -04:00
notes/node_modules/stylelint/lib/rules/declaration-property-value-blacklist/README.md
Patrick Marsceill b7b0d0d7bf
Initial commit
2017-03-09 13:16:08 -05:00

2.1 KiB

declaration-property-value-blacklist

Specify a blacklist of disallowed property and value pairs within declarations.

a { text-transform: uppercase; }
/** ↑               ↑
 * These properties and these values */

Options

object: { "unprefixed-property-name": ["array", "of", "values"], "unprefixed-property-name": ["/regex/", "non-regex"] }

If a property name is surrounded with "/" (e.g. "/^animation/"), it is interpreted as a regular expression. This allows, for example, easy targeting of shorthands: /^animation/ will match animation, animation-duration, animation-timing-function, etc.

The same goes for values. Keep in mind that a regular expression value is matched against the entire value of the declaration, not specific parts of it. For example, a value like "10px solid rgba( 255 , 0 , 0 , 0.5 )" will not match "/^solid/" (notice beginning of the line boundary) but will match "/\\s+solid\\s+/" or "/\\bsolid\\b/".

Be careful with regex matching not to accidentally consider quoted string values and url() arguments. For example, "/red/" will match value such as "1px dotted red" as well as "\"foo\"" and "white url(/mysite.com/red.png)".

Given:

{
  "transform": ["/scale3d/", "/rotate3d/", "/translate3d/"],
  "position": ["fixed"],
  "color": ["/^green/"],
  "/^animation/": ["/ease/"]
}

The following patterns are considered warnings:

a { position: fixed; }
a { transform: scale3d(1, 2, 3); }
a { -webkit-transform: scale3d(1, 2, 3); }
a { color: green; }
a { animation: foo 2s ease-in-out; }
a { animation-timing-function: ease-in-out; }
a { -webkit-animation-timing-function: ease-in-out; }

The following patterns are not considered warnings:

a { position: relative; }
a { transform: scale(2); }
a { -webkit-transform: scale(2); }
a { color: lightgreen; }
a { animation: foo 2s linear; }
a { animation-timing-function: linear; }
a { -webkit-animation-timing-function: linear; }