render_block_core_navigation_link()


WordPressのrender_block_core_navigation_link()関数は、ナビゲーションブロック内のリンクをレンダリングするために使用されます。この関数は、ナビゲーションメニューのリンク要素を生成し、適切なHTMLを出力します。

構文

render_block_core_navigation_link( array $attributes, string $content, WP_Block $block );

引数の説明:

  • $attributes(array) — リンクの属性を指定する配列。例えば、URL、ラベル、ターゲットなど。
  • $content(string) — リンクのコンテンツ。通常は空ですが、カスタムコンテンツを渡すことができます。
  • $block(WP_Block) — 現在のブロックオブジェクト。

例1: 基本的なナビゲーションリンクのレンダリング

これは、ナビゲーションメニュー内のリンクをレンダリングする基本的な例です。

<?php echo render_block_core_navigation_link( array( 'url' => get_home_url(), 'label' => 'ホーム' ), '', $block ); ?>

例2: 外部リンクの追加

外部リンクをナビゲーションメニューに追加する例です。

<?php echo render_block_core_navigation_link( array( 'url' => 'https://example.com', 'label' => '外部リンク', 'opensInNewTab' => true ), '', $block ); ?>

例3: カスタムクラスの追加

リンクにカスタムクラスを追加する例です。

<?php echo render_block_core_navigation_link( array( 'url' => get_permalink(), 'label' => '投稿', 'className' => 'custom-link' ), '', $block ); ?>

例4: アイコンの追加

リンクにアイコンを追加する例です。

<?php echo render_block_core_navigation_link( array( 'url' => get_category_link( 1 ), '<span class="dashicons dashicons-admin-post"></span>カテゴリー', $block ); ?>

例5: カスタムIDの設定

リンクにカスタムIDを設定する例です。

<?php echo render_block_core_navigation_link( array( 'url' => get_author_posts_url( 1 ), 'label' => '著者', 'id' => 'author-link' ), '', $block ); ?>

例6: リンクの無効化

リンクを無効化する例です。

<?php echo render_block_core_navigation_link( array( 'url' => '#', 'label' => '無効リンク', 'isDisabled' => true ), '', $block ); ?>

例7: カスタムスタイルの適用

リンクにカスタムスタイルを適用する例です。

<?php echo render_block_core_navigation_link( array( 'url' => get_tag_link( 1 ), 'label' => 'タグ', 'style' => array( 'color' => '#ff0000' ) ), '', $block ); ?>

注意点

  • この関数は、ナビゲーションブロックのコンテキスト内でのみ使用することを推奨します。
  • カスタム属性を追加する場合は、適切なエスケープ処理を行ってください。
  • リンクのURLやラベルが正しく設定されていることを確認してください。

関連機能：