wp_apply_typography_support()


WordPressのwp_apply_typography_support()関数は、テーマやブロックエディタでタイポグラフィのサポートを適用するために使用されます。フォントサイズや行の高さなどの設定を簡単に管理できます。

構文

wp_apply_typography_support( string $block_type, array $args );

引数の説明:

  • $block_type(string)—ブロックタイプの名前（例:’core/paragraph’）
  • $args(array)—タイポグラフィ設定の配列

例1:段落ブロックにフォントサイズを追加

段落ブロックにフォントサイズのサポートを追加します。

add_theme_support('editor-font-sizes',[['name'=>'小','size'=>'14px','slug'=>'small']]);wp_apply_typography_support('core/paragraph',['fontSize'=>true]);

例2:見出しブロックに行の高さを設定

見出しブロックに行の高さオプションを有効にします。

wp_apply_typography_support('core/heading',['lineHeight'=>true]);

例3:ボタンブロックにカスタムフォントを適用

ボタンブロックでカスタムフォントファミリーを使用可能にします。

wp_apply_typography_support('core/button',['__experimentalFontFamily'=>true]);

例4:引用ブロックに文字間隔を追加

引用ブロックで文字間隔の調整を有効化します。

wp_apply_typography_support('core/quote',['letterSpacing'=>true]);

例5:グループブロックで複数のタイポグラフィ設定を適用

グループブロックに複数のタイポグラフィオプションを一度に設定します。

wp_apply_typography_support('core/group',['fontSize'=>true,'lineHeight'=>true]);

例6:カスタムブロックにタイポグラフィサポートを追加

カスタムブロックに対してタイポグラフィ機能を実装します。

wp_apply_typography_support('my-plugin/custom-block',['fontSize'=>true,'customFontSize'=>true]);

例7:投稿タイトルのフォントスタイルを変更

投稿タイトルブロックにフォントスタイルオプションを追加します。

wp_apply_typography_support('core/post-title',['fontStyle'=>true,'fontWeight'=>true]);

注意点

  • この関数はWordPress5.8以降で利用可能です
  • テーマでadd_theme_support()を事前に設定する必要があります
  • 引数の配列キーはブロックエディタの仕様に準拠する必要があります

関連機能：