src | CSS

在此页

句法
描述
形式定义
形式句法
范例
规范
浏览器兼容性
另请参阅
相关话题

src CSS descriptor of the @font-face rule specifies the resource containing font data. It is required for the @font-face rule to be valid.

句法

/* <url> values */
src: url(https://somewebsite.com/path/to/font.woff); /* Absolute URL */
src: url(path/to/font.woff);                         /* Relative URL */
src: url(path/to/font.woff) format("woff");          /* Explicit format */
src: url('path/to/font.woff');                       /* Quoted URL */
src: url(path/to/svgfont.svg#example);               /* Fragment identifying font */
/* <font-face-name> values */
src: local(font);      /* Unquoted name */
src: local(some font); /* Name containing space */
src: local("font");    /* Quoted name */
/* Multiple items */
src: local(font), url(path/to/font.svg) format("svg"),
     url(path/to/font.woff) format("woff"),
     url(path/to/font.otf) format("opentype");

值

<url> [ format( <string># ) ]?: Specifies an external reference consisting of a <url> , followed by an optional hint using the format() function to describe the format of the font resource referenced by that URL. The format hint contains a comma-separated list of format strings that denote well-known font formats. If a user agent doesn't support the specified formats, it skips downloading the font resource. If no format hints are supplied, the font resource is always downloaded.
<font-face-name>: Specifies the name of a locally-installed font face using the local() function, which uniquely identifies a single font face within a larger family. The name can optionally be enclosed in quotes.

描述

The value of this descriptor is a prioritized, comma-separated list of external references or locally-installed font face names. When a font is needed the 用户代理 iterates over the set of references listed using the first one it can successfully activate. Fonts containing invalid data or local font faces that are not found are ignored and the user agent loads the next font in the list.

As with other URLs in CSS, the URL may be relative, in which case it is resolved relative to the location of the style sheet containing the @font-face rule. In the case of SVG fonts, the URL points to an element within a document containing SVG font definitions. If the element reference is omitted, a reference to the first defined font is implied. Similarly, font container formats that can contain more than one font load only one of the fonts for a given @font-face rule. Fragment identifiers are used to indicate which font to load. If a container format lacks a defined fragment identifier scheme, a simple 1-based indexing scheme (e.g., "font-collection#1" for the first font, "font-collection#2" for the second font, etc.) is used.

形式定义

相关 at-rule	`@font-face`
初始值	`n/a (required)`
计算值	如指定

形式句法

[ <url> [ format( <string># ) ]? | local( <family-name> ) ]#where 
<family-name> = <string> | <custom-ident>+

范例

Specifying font resources using url() and local()

@font-face {
  font-family: examplefont;
  src: local(Example Font),
       url('examplefont.woff') format("woff"),
       url('examplefont.otf') format("opentype");
}

规范

规范	状态	注释
CSS Fonts Module Level 3 The definition of 'src' 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
`src`	Chrome 完整支持 4	Edge 完整支持 12	Firefox 完整支持 3.5	IE 完整支持 6	Opera 完整支持 10	Safari 完整支持 3.1	WebView Android 完整支持 2.2	Chrome Android 完整支持 18	Firefox Android 完整支持 4	Opera Android 完整支持 10.1	Safari iOS 完整支持 3.1	Samsung Internet Android 完整支持 1.0
支持 `format` 关键词	Chrome 不支持 No	Edge 不支持 No	Firefox 不支持 No	IE 不支持 No	Opera 不支持 No	Safari 完整支持 4	WebView Android 不支持 No	Chrome Android 不支持 No	Firefox Android 不支持 No	Opera Android 不支持 No	Safari iOS 完整支持 5	Samsung Internet Android 不支持 No

图例

完整支持
不支持

另请参阅

元数据

最后修改： Aug 19, 2020

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

在此页

句法

值

描述

形式定义

形式句法

范例

Specifying font resources using url() and local()

规范

浏览器兼容性

图例

另请参阅

相关话题