notes/node_modules/stylelint/lib/rules/font-weight-notation/README.md

1.7 KiB

font-weight-notation

Require numeric or named (where possible) font-weight values. Also, when named values are expected, require only valid names.

a { font-weight: bold }
/**              ↑
 *   This notation */

a { font: italic small-caps 600 16px/3 cursive; }
/**                         ↑
*      And this notation, too */

Valid font-weight names are normal, bold, bolder, and lighter.

This rule ignores $sass, @less, and var(--custom-property) variable syntaxes.

Options

string: "numeric"|"named-where-possible"

"numeric"

font-weight values must always be numbers.

The following patterns are considered warnings:

a { font-weight: bold; }
a { font: italic normal 20px; }

The following patterns are not considered warnings:

a { font-weight: 700; }
a { font: italic 900 20px; }

"named-where-possible"

font-weight values must always be keywords when an appropriate keyword is available.

This means that only 400 and 700 will be rejected, because those are the only numbers with keyword equivalents (normal and bold).

The following patterns are considered warnings:

a { font-weight: 700; }
a { font: italic 400 20px; }

The following patterns are not considered warnings:

a { font-weight: bold; }
a { font: italic normal 20px; }

Optional secondary options

ignore: ["relative"]

Ignore the relative keyword names of bolder and lighter.

The following patterns are not considered warnings:

a { font-weight: 400; }
a b { font-weight: lighter; }