wp_print_font_faces() │ WP 6.4.0

Генерирует и выводит CSS-правила @font-face для указанных шрифтов.

Если шрифты не переданы, получает их из файла theme.json активной темы. CSS выводится внутри элемента <style class="wp-fonts-local">.

Хуков нет.

Возвращает

null.

  • void - выводит CSS и ничего не возвращает.

Использование

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

Семейства шрифтов и их начертания.

По умолчанию: []

  • ...$0(массив)
    Индексированный или ассоциативный массив начертаний одного семейства шрифтов.

    • ...$0(массив)
      Свойства отдельного начертания.

      • font-family(строка)
        Название семейства шрифтов.

      • src(строка|string[])
        URL файла шрифта или массив URL.

      • font-style(строка)
        Стиль шрифта.
        По умолчанию: 'normal'

      • font-weight(строка)
        Насыщенность шрифта.
        По умолчанию: '400'

      • font-display(строка)
        Способ отображения шрифта во время его загрузки.
        По умолчанию: 'fallback'

      • ascent-override(строка)
        Переопределяет высоту над базовой линией.

      • descent-override(строка)
        Переопределяет глубину под базовой линией.

      • font-stretch(строка)
        Степень растяжения шрифта.

      • font-variant(строка)
        Вариант начертания шрифта.

      • font-feature-settings(строка)
        Настройки OpenType-возможностей шрифта.

      • font-variation-settings(строка)
        Настройки осей вариативного шрифта.

      • line-gap-override(строка)
        Переопределяет межстрочный интервал.

      • size-adjust(строка)
        Масштабирует контуры и метрики шрифта.

      • unicode-range(строка)
        Диапазон символов Unicode, для которых используется шрифт.

Примеры

#1 Вывод собственного шрифта

add_action( 'wp_head', 'my_print_font_faces', 50 );

function my_print_font_faces(): void {
	wp_print_font_faces( [
		'my-font' => [
			[
				'font-family' => 'My Font',
				'src'         => get_theme_file_uri( 'assets/fonts/my-font.woff2' ),
				'font-weight' => '400',
				'font-style'  => 'normal',
				'font-display' => 'swap',
			],
		],
	] );
}

Список изменений

С версии 6.4.0 Введена.

Код wp_print_font_faces() WP 7.1

wp-includes/fonts.php 
function wp_print_font_faces( $fonts = array() ) {

	if ( empty( $fonts ) ) {
		$fonts = WP_Font_Face_Resolver::get_fonts_from_theme_json();
	}

	if ( empty( $fonts ) ) {
		return;
	}

	$wp_font_face = new WP_Font_Face();
	$wp_font_face->generate_and_print( $fonts );
}

Другие функции темы