wp_print_font_faces( array[][] $fonts = array() )

Parameters

$fontsarray[][]optional

The font-families and their font faces. Default empty array. @type array ...$0 { An indexed or associative (keyed by font-family) array of font variations for this font-family. Each font face has the following structure. @type array ...$0 { The font face properties.Default: array()

• $fontstring

  -family The font-family property.

• $srcstring|string[]

  The URL(s) to each resource containing the font data.

• $fontstringdefault: 'normal'

  -style Optional. The font-style property.

• $fontstringdefault: '400'

  -weight Optional. The font-weight property.

• $fontstringdefault: 'fallback'

  -display Optional. The font-display property.

• $ascentstring

  -override Optional. The ascent-override property.

• $descentstring

  -override Optional. The descent-override property.

• $fontstring

  -stretch Optional. The font-stretch property.

• $fontstring

  -variant Optional. The font-variant property.

• $fontstring

  -feature-settings Optional. The font-feature-settings property.

• $fontstring

  -variation-settings Optional. The font-variation-settings property.

• $linestring

  -gap-override Optional. The line-gap-override property.

• $sizestring

  -adjust Optional. The size-adjust property.

• $unicodestring

  -range Optional. The unicode-range property. } }

Uses · 2

• WP_Font_Face_Resolver::get_fonts_from_theme_json()Gets fonts defined in theme.json.
• WP_Font_Face::__construct()Creates and initializes an instance of WP_Font_Face.

Used by · 2

• _wp_get_iframed_editor_assets()Collect the block editor assets that need to be loaded into the editor's iframe.
• wp_print_font_faces_from_style_variations()Generates and prints font-face styles defined the the theme style variations.

Source

View on Trac ↗View on GitHub ↗

43function wp_print_font_faces( $fonts = array() ) {44 45	if ( empty( $fonts ) ) {46		$fonts = WP_Font_Face_Resolver::get_fonts_from_theme_json();47	}48 49	if ( empty( $fonts ) ) {50		return;51	}52 53	$wp_font_face = new WP_Font_Face();54	$wp_font_face->generate_and_print( $fonts );55}

History

Introduced in 6.4.0. Unchanged from 6.7.7 through 7.1.0.

1. 6.7.7
2. 6.8.8
3. 6.9.7
4. 7.0.4
5. 7.1.0

Signature, return type and hooks compared across 5 parsed releases.

About this page

Parsed data

Generated from the wordpress-develop 6.7.7 tag, from src/wp-includes/fonts.php, and regenerated for each WordPress release so it tracks the code rather than a snapshot of it.

Corrections

Something wrong on this page? Report it and it gets fixed in the next regeneration.