1 # font-family-name-quotes
3 Specify whether or not quotation marks should be used around font family names.
6 a { font-family: "Times New Roman", 'Ancient Runes', serif; }
8 * These quotation marks and this one */
11 This rule checks the `font` and `font-family` properties.
13 This rule ignores `$sass`, `@less`, and `var(--custom-property)` variable syntaxes.
17 `string`: `"always-where-required"|"always-where-recommended"|"always-unless-keyword"`
19 *Please read the following to understand these options*:
21 - The `font` and `font-family` properties accept a short list of special **keywords**: `inherit`, `serif`, `sans-serif`, `cursive`, `fantasy`, and `monospace`. If you wrap these words in quotes, the browser will not interpret them as keywords, but will instead look for a font by that name (e.g. will look for a `"sans-serif"` font) -- which is almost *never* what you want. Instead, you use these keywords to point to the built-in, generic fallbacks (right?). Therefore, *all of the options below enforce no quotes around these keywords*. (If you actually want to use a font named `"sans-serif"`, turn this rule off.)
22 - Quotes are **recommended** [in the spec](https://www.w3.org/TR/CSS2/fonts.html#font-family-prop) with "font family names that contain white space, digits, or punctuation characters other than hyphens".
23 - Quotes are **required** around font-family names when they are not [valid CSS identifiers](https://www.w3.org/TR/CSS2/syndata.html#value-def-identifier). For example, a font family name requires quotes around it if it contains `$`, `!`, or `/`, but does not require quotes just because it contains spaces or a (non-initial) number or underscore. *You can probably bet that almost every font family name you use **will** be a valid CSS identifier*.
24 - Quotes should **never** be used around vendor prefixed system fonts such as `-apple-system` and `BlinkMacSystemFont`.
26 For more on these subtleties, read ["Unquoted font family names in CSS"](https://mathiasbynens.be/notes/unquoted-font-family), by Mathias Bynens.
28 **Caveat:** This rule does not currently understand escape sequences such as those described by Mathias. If you want to use the font family name "Hawaii 5-0" you will need to wrap it in quotes, instead of escaping it as `Hawaii \35 -0` or `Hawaii\ 5-0`.
30 ### `"always-unless-keyword"`
32 Expect quotes around every font family name that is not a keyword.
34 The following patterns are considered violations:
37 a { font-family: Arial, sans-serif; }
41 a { font-family: Times New Roman, Times, serif; }
45 a { font: 1em Arial, sans-serif; }
48 The following patterns are *not* considered violations:
51 a { font-family: 'Arial', sans-serif; }
55 a { font-family: "Times New Roman", "Times", serif; }
59 a { font: 1em 'Arial', sans-serif; }
62 ### `"always-where-required"`
64 Expect quotes only when quotes are *required* according to the criteria above, and disallow quotes in all other cases.
66 The following patterns are considered violations:
69 a { font-family: "Arial", sans-serif; }
73 a { font-family: 'Times New Roman', Times, serif; }
77 a { font: 1em "Arial", sans-serif; }
80 The following patterns are *not* considered violations:
83 a { font-family: Arial, sans-serif; }
87 a { font-family: Arial, sans-serif; }
91 a { font-family: Times New Roman, Times, serif; }
95 a { font-family: "Hawaii 5-0"; }
99 a { font: 1em Arial, sans-serif; }
102 ### `"always-where-recommended"`
104 Expect quotes only when quotes are *recommended* according to the criteria above, and disallow quotes in all other cases. (This includes all cases where quotes are *required*, as well.)
106 The following patterns are considered violations:
109 a { font-family: Times New Roman, Times, serif; }
113 a { font-family: MyFontVersion6, sake_case_font; }
117 a { font-family: 'Arial', sans-serif; }
121 a { font: 1em Times New Roman, Times, serif; }
124 The following patterns are *not* considered violations:
127 a { font-family: 'Times New Roman', Times, serif; }
131 a { font-family: "MyFontVersion6", "sake_case_font"; }
135 a { font-family: Arial, sans-serif; }
139 a { font: 1em 'Times New Roman', Times, serif; }