wp_render_typography_support()


WordPressのwp_render_typography_support()関数は、テーマやプラグインでタイポグラフィサポートをレンダリングするために使用されます。この関数は、ブロックエディタで定義されたタイポグラフィ設定をフロントエンドに適用する役割を果たします。

構文

wp_render_typography_support( string $block_content, array $block );

引数の説明:

  • $block_content(string) — ブロックのコンテンツ。
  • $block(array) — ブロックの属性と設定を含む配列。

例1: 基本的な使用例

この例では、ブロックのタイポグラフィサポートをレンダリングします。

add_filter( 'render_block', 'custom_render_typography', 10, 2 ); function custom_render_typography( $block_content, $block ) { return wp_render_typography_support( $block_content, $block ); }

例2: カスタムブロックでのタイポグラフィサポート

カスタムブロックにタイポグラフィサポートを追加する例です。

register_block_type( 'my-plugin/custom-block', array( 'attributes' => array( 'typography' => array( 'type' => 'object' ) ), 'render_callback' => function( $attributes, $content ) { return wp_render_typography_support( $content, $attributes ); } ) );

例3: 特定のブロックのみに適用

特定のブロックにのみタイポグラフィサポートを適用します。

add_filter( 'render_block', function( $block_content, $block ) { if ( 'core/paragraph' === $block['blockName'] ) { return wp_render_typography_support( $block_content, $block ); } return $block_content; }, 10, 2 );

例4: タイポグラフィ設定の上書き

タイポグラフィ設定を上書きしてカスタマイズします。

add_filter( 'render_block', function( $block_content, $block ) { if ( isset( $block['attrs']['typography'] ) ) { $block['attrs']['typography']['fontSize'] = '24px'; } return wp_render_typography_support( $block_content, $block ); }, 10, 2 );

例5: 条件付きタイポグラフィサポート

特定の条件でタイポグラフィサポートを適用します。

add_filter( 'render_block', function( $block_content, $block ) { if ( is_single() ) { return wp_render_typography_support( $block_content, $block ); } return $block_content; }, 10, 2 );

例6: カスタムフォントサイズの適用

カスタムフォントサイズを適用する例です。

add_filter( 'render_block', function( $block_content, $block ) { if ( isset( $block['attrs']['typography'] ) ) { $block['attrs']['typography']['customFontSize'] = '30px'; } return wp_render_typography_support( $block_content, $block ); }, 10, 2 );

例7: タイポグラフィサポートの無効化

特定のブロックでタイポグラフィサポートを無効にします。

add_filter( 'render_block', function( $block_content, $block ) { if ( 'core/heading' === $block['blockName'] ) { return $block_content; } return wp_render_typography_support( $block_content, $block ); }, 10, 2 );

注意点

  • この関数はブロックエディタのタイポグラフィ設定に依存します。
  • カスタムブロックで使用する場合、適切な属性を定義する必要があります。
  • タイポグラフィ設定が正しく適用されない場合、ブロックの属性を確認してください。

関連機能：