1
0
mirror of https://github.com/thangisme/notes.git synced 2024-11-01 06:17:18 -04:00
notes/node_modules/stylelint/lib/rules/font-weight-notation/README.md
Patrick Marsceill b7b0d0d7bf
Initial commit
2017-03-09 13:16:08 -05:00

85 lines
1.7 KiB
Markdown

# font-weight-notation
Require numeric or named (where possible) `font-weight` values. Also, when named values are expected, require only valid names.
```css
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:
```css
a { font-weight: bold; }
```
```css
a { font: italic normal 20px; }
```
The following patterns are *not* considered warnings:
```css
a { font-weight: 700; }
```
```css
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:
```css
a { font-weight: 700; }
```
```css
a { font: italic 400 20px; }
```
The following patterns are *not* considered warnings:
```css
a { font-weight: bold; }
```
```css
a { font: italic normal 20px; }
```
## Optional secondary options
### `ignore: ["relative"]`
Ignore the [*relative*](https://drafts.csswg.org/css-fonts/#font-weight-prop) keyword names of `bolder` and `lighter`.
The following patterns are *not* considered warnings:
```css
a { font-weight: 400; }
a b { font-weight: lighter; }
```