wp_print_font_faces

パラメータ

• $fonts
  フォントファミリーとそのバリエーションを含んだ連想配列を含む配列を指定（省略時はarray()）。

  キー	内容
  font-family	font-familyプロパティ値（フォントファミリー名）
  src	フォントファイルのURLかその配列
  font-style	font-styleプロパティ値（省略時は'normal'）
  font-weight	font-weightプロパティ値（省略時は'400'）
  font-display	font-displayプロパティ値（省略時は'fallback'）
  ascent-override	ascent-overrideプロパティ値
  descent-override	descent-overrideプロパティ値
  font-stretch	font-stretchプロパティ値
  font-variant	font-variantプロパティ値
  font-feature-settings	font-feature-settingsプロパティ値
  font-variation-settings	font-variation-settingsプロパティ値
  line-gap-override	line-gap-overrideプロパティ値
  size-adjust	size-adjustプロパティ値
  unicode-range	unicode-rangeプロパティ値

返り値

注意

本関数は標準で'wp_head'アクションとして優先度50で登録されており、通常は呼び出すことはない。

パラメータ$fontsが省略された場合は、現在のテーマのtheme.jsonで指定されているフォントフェイス内容が適用される。

新テーマ「Twenty Twenty-Four」では以下の内容が出力されている。

<style id='wp-fonts-local'>
@font-face{font-family:Inter;font-style:normal;font-weight:300 900;font-display:fallback;src:url('http://localhost/wp-content/themes/twentytwentyfour/assets/fonts/inter/Inter-VariableFont_slnt,wght.woff2') format('woff2');font-stretch:normal;}
@font-face{font-family:Cardo;font-style:normal;font-weight:400;font-display:fallback;src:url('http://localhost/wp-content/themes/twentytwentyfour/assets/fonts/cardo/cardo_normal_400.woff2') format('woff2');}
@font-face{font-family:Cardo;font-style:italic;font-weight:400;font-display:fallback;src:url('http://localhost/wp-content/themes/twentytwentyfour/assets/fonts/cardo/cardo_italic_400.woff2') format('woff2');}
@font-face{font-family:Cardo;font-style:normal;font-weight:700;font-display:fallback;src:url('http://localhost/wp-content/themes/twentytwentyfour/assets/fonts/cardo/cardo_normal_700.woff2') format('woff2');}
</style>

使用例

• 任意のフォントフェイス・スタイルを表示する

  wp_print_font_faces( [
  	"Inter" => [
  		0 => [
  			"src"          => [ get_theme_file_uri( "assets/fonts/inter/Inter-VariableFont_slnt,wght.woff2" ) ],
  			"font-family"  => "Inter",
  			"font-stretch" => "normal",
  			"font-style"   => "normal",
  			"font-weight"  => "300 900",
  		]
  	]
  ] );
  

フィルター

アクション

ソースファイル