wp_register_typography_support()


WordPressのwp_register_typography_support()関数は、ブロックテーマでタイポグラフィサポートを登録するために使用されます。この関数はtheme.json内でタイポグラフィ設定を有効化します。

構文

wp_register_typography_support( string $block_type, array $typography_properties = array() );

引数の説明:

  • $block_type(string) — ブロックタイプの名前（例: ‘core/paragraph’）
  • $typography_properties(array) — 有効にするタイポグラフィプロパティの配列（例: array( ‘fontSize’, ‘lineHeight’ )）

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

基本的なタイポグラフィサポートの登録例です。

wp_register_typography_support( 'core/paragraph', array( 'fontSize' ) );

例2: 見出しブロックに複数プロパティを追加

複数のタイポグラフィプロパティを一度に登録します。

wp_register_typography_support( 'core/heading', array( 'fontSize', 'lineHeight', 'fontWeight' ) );

例3: カスタムブロックに適用

カスタムブロックに対してタイポグラフィサポートを設定します。

wp_register_typography_support( 'my-plugin/custom-block', array( 'fontFamily', 'fontStyle' ) );

例4: すべてのプロパティを有効化

利用可能なすべてのタイポグラフィプロパティを登録します。

wp_register_typography_support( 'core/paragraph', array( 'fontSize', 'fontFamily', 'fontWeight', 'fontStyle', 'lineHeight', 'letterSpacing' ) );

例5: コールバック関数内で使用

initフック内で関数を呼び出します。

add_action( 'init', function() { wp_register_typography_support( 'core/list', array( 'fontSize' ) ); } );

例6: 条件付きで登録

特定の条件下でのみタイポグラフィサポートを登録します。

if ( function_exists( 'wp_register_typography_support' ) ) { wp_register_typography_support( 'core/quote', array( 'fontSize' ) ); }

例7: 子テーマでの上書き

親テーマの設定を子テーマで上書きします。

add_action( 'after_setup_theme', function() { wp_register_typography_support( 'core/paragraph', array( 'fontSize', 'fontFamily' ) ); }, 20 );

注意点

  • この関数はブロックテーマでのみ有効です
  • theme.jsonの設定と連携して動作します
  • WordPress 5.8以降で利用可能です

関連機能：