font-family

在此页

句法
形式定义
形式句法
范例
规范
浏览器兼容性
相关话题

font-family CSS property specifies a prioritized list of one or more font family names and/or generic family names for the selected element.

The source for this interactive example is stored in a GitHub repository. If you'd like to contribute to the interactive examples project, please clone https://github.com/mdn/interactive-examples and send us a pull request.

Values are separated by commas to indicate that they are alternatives. The browser will select the first font in the list that is installed or that can be downloaded using a @font-face at-rule.

It is often convenient to use the shorthand property font to set font-size and other font related properties all at once.

You should always include at least one generic family name in a font-family list, since there's no guarantee that any given font is available. This lets the browser select an acceptable fallback font when necessary.

font-family property specifies a list of fonts, from highest priority to lowest. Font selection does not simply stop at the first font in the list that is on the user's system. Rather, font selection is done one character at a time , so that if an available font does not have a glyph for a needed character, the latter fonts are tried. (However, this doesn't work in Internet Explorer 6 or earlier.) When a font is only available in some styles , variants ，或 sizes , those properties may also influence which font family is chosen.

句法

/* A font family name and a generic family name */
font-family: Gill Sans Extrabold, sans-serif;
font-family: "Goudy Bookletter 1911", sans-serif;
/* A generic family name only */
font-family: serif;
font-family: sans-serif;
font-family: monospace;
font-family: cursive;
font-family: fantasy;
font-family: system-ui;
font-family: ui-serif;
font-family: ui-sans-serif;
font-family: ui-monospace;
font-family: ui-rounded;
font-family: emoji;
font-family: math;
font-family: fangsong;
/* Global values */
font-family: inherit;
font-family: initial;
font-family: unset;

font-family property lists one or more font families, separated by commas. Each font family is specified as either a <family-name> 或 <generic-name> 值。

The example below lists two font families, the first with a <family-name> and the second with a <generic-name> :

font-family: Gill Sans Extrabold, sans-serif;

值

<family-name>
<generic-name>

serif: Glyphs have finishing strokes, flared or tapering ends, or have actual serifed endings.
E.g. Lucida Bright , Lucida Fax , Palatino , "Palatino Linotype" , Palladio , "URW Palladio" , serif .
sans-serif: Glyphs have stroke endings that are plain.
E.g. "Open Sans" , "Fira Sans" , "Lucida Sans" , "Lucida Sans Unicode" , "Trebuchet MS" , "Liberation Sans" , "Nimbus Sans L" , sans-serif .
monospace: All glyphs have the same fixed width.
E.g. "Fira Mono" , "DejaVu Sans Mono" , Menlo , Consolas , "Liberation Mono" , Monaco , "Lucida Console" , monospace .
cursive: Glyphs in cursive fonts generally have either joining strokes or other cursive characteristics beyond those of italic typefaces. The glyphs are partially or completely connected, and the result looks more like handwritten pen or brush writing than printed letterwork.
E.g. "Brush Script MT ", "Brush Script Std ", "Lucida Calligraphy" , "Lucida Handwriting" , "Apple Chancery" , cursive .
fantasy: Fantasy fonts are primarily decorative fonts that contain playful representations of characters.
E.g. Papyrus , Herculanum , Party LET , Curlz MT , Harrington , fantasy .
system-ui: Glyphs are taken from the default user interface font on a given platform. Because typographic traditions vary widely across the world, this generic is provided for typefaces that don't map cleanly into the other generics. This is example system-ui text.
ui-serif: The default user interface serif font. This is example ui-serif text.
ui-sans-serif: The default user interface sans-serif font. This is example ui-sans-serif text.
ui-monospace: The default user interface monospace font. This is example ui-monospace text.
ui-rounded: The default user interface font that has rounded features. This is example ui-rounded text.
math: This is for the particular stylistic concerns of representing mathematics: superscript and subscript, brackets that cross several lines, nesting expressions, and double struck glyphs with distinct meanings. This is some example math text: ax² + bx + c = 0 .
emoji: Fonts that are specifically designed to render emoji. This is some example emoji text: ✝♾ .
fangsong: A particular style of Chinese characters that are between serif-style Song and cursive-style Kai forms. This style is often used for government documents. This is some example fangsong text with the Chinese characters for "fangsong" in traditional and simple forms, respectively: 仿宋體仿宋体 .

Valid family names

Font family names must either be given quoted as strings, or unquoted as a sequence of one or more identifiers. This means that punctuation characters and digits at the start of each token must be escaped in unquoted font family names.

For example, the following declarations are valid:

font-family: Gill Sans Extrabold, sans-serif;
font-family: "Goudy Bookletter 1911", sans-serif;

The following declarations are invalid :

font-family: Goudy Bookletter 1911, sans-serif;
font-family: Red/Black, sans-serif;
font-family: "Lucida" Grande, sans-serif;
font-family: Ahem!, sans-serif;
font-family: test@foo, sans-serif;
font-family: #POUND, sans-serif;
font-family: Hawaii 5-0, sans-serif;

形式定义

初始值	depends on user agent
适用于	所有元素。它还适用于 `::first-letter` and `::first-line` .
继承	yes
计算值	如指定
动画类型	discrete

形式句法

[ <family-name> | <generic-family> ]#where 
<family-name> = <string> | <custom-ident>+
<generic-family> = serif | sans-serif | cursive | fantasy | monospace

范例

Some common font families

.serif {
  font-family: Times, Times New Roman, Georgia, serif;
}
.sansserif {
  font-family: Verdana, Arial, Helvetica, sans-serif;
}
.monospace {
  font-family: Lucida Console, Courier, monospace;
}
.cursive {
  font-family: cursive;
}
.fantasy {
  font-family: fantasy;
}
.emoji {
  font-family: emoji;
}
.math {
  font-family: math;
}
.fangsong {
  font-family: fangsong;
}

<div class="serif">
  This is an example of a serif font.
</div>
<div class="sansserif">
  This is an example of a sans-serif font.
</div>
<div class="monospace">
  This is an example of a monospace font.
</div>
<div class="cursive">
  This is an example of a cursive font.
</div>
<div class="fantasy">
  This is an example of a fantasy font.
</div>
<div class="math">
  This is an example of a math font.
</div>
<div class="emoji">
  This is an example of an emoji font.
</div>
<div class="fangsong">
  This is an example of a fangsong font.
</div>

规范

规范	状态	注释
CSS Fonts Module Level 4 The definition of 'generic font families' in that specification.	工作草案	Adds new generic font families, specifically: `system-ui` , `ui-serif` , `ui-sans-serif` , `ui-monospace` , `ui-rounded` , `emoji` , `math` ，和 `fangsong` .
CSS Fonts Module Level 3 The definition of 'font-family' in that specification.	候选推荐	No significant change
CSS Level 2 (Revision 1) The definition of 'font-family' in that specification.	推荐	No significant change
CSS Level 1 The definition of 'font-family' in that specification.	推荐	初始定义

浏览器兼容性

The compatibility table on this page is generated from structured data. If you'd like to contribute to the data, please check out https://github.com/mdn/browser-compat-data and send us a pull request. 更新 GitHub 上的兼容性数据

	Desktop						Mobile
	Chrome	Edge	Firefox	Internet Explorer	Opera	Safari	Android webview	Chrome for Android	Firefox for Android	Opera for Android	Safari on iOS	Samsung Internet
`font-family`	Chrome 完整支持 1	Edge 完整支持 12	Firefox 完整支持 1 注意事项完整支持 1 注意事项注意事项 Not supported on `option` elements. See bug 1536148 .	IE 完整支持 3	Opera 完整支持 3.5	Safari 完整支持 1	WebView Android 完整支持 1	Chrome Android 完整支持 18	Firefox Android 完整支持 4	Opera Android 完整支持 10.1	Safari iOS 完整支持 1	Samsung Internet Android 完整支持 1.0
`system-ui`	Chrome 完整支持 56	Edge 完整支持 79	Firefox 不支持 No 不支持 No 完整支持 43 注意事项 Alternate Name 注意事项 Supported on macOS only. Alternate Name Uses the non-standard name: `-apple-system`	IE 不支持 No	Opera 完整支持 43	Safari 完整支持 9 注意事项 Alternate Name 完整支持 9 注意事项 Alternate Name 注意事项 Supported since macOS 10.11. Alternate Name Uses the non-standard name: `-apple-system`	WebView Android 完整支持 56	Chrome Android 完整支持 56	Firefox Android 不支持 No	Opera Android 完整支持 43	Safari iOS 完整支持 9 Alternate Name 完整支持 9 Alternate Name Alternate Name Uses the non-standard name: `-apple-system`	Samsung Internet Android 完整支持 6.0

图例

完整支持
不支持
见实现注意事项。
使用非标名称。

元数据

最后修改： 2020 年 7 月 17 日

CSS
CSS 参考
CSS 字体
指南
1. OpenType font features guide
2. Variable fonts guide
At-Rules
1. @font-face
2. @font-feature-values
特性

在此页

句法

值

Valid family names

形式定义

形式句法

范例

Some common font families

规范

浏览器兼容性

图例

相关话题