register_block_core_navigation_link()


WordPressのregister_block_core_navigation_link()関数は、ナビゲーションメニューにリンクブロックを登録するために使用されます。この関数は、ブロックエディタ内でカスタムリンクを追加する際に役立ちます。

構文

register_block_core_navigation_link( array $args );

引数の説明:

  • $args(array) — ブロックの設定を定義する配列。以下のキーを含むことができます:
    • 'title'(string) — ブロックのタイトル。
    • 'description'(string) — ブロックの説明。
    • 'category'(string) — ブロックが属するカテゴリー。
    • 'icon'(string) — ブロックのアイコン。
    • 'keywords'(array) — ブロックを検索するためのキーワード。

例1: 基本的なナビゲーションリンクブロックの登録

この例では、シンプルなナビゲーションリンクブロックを登録します。

register_block_core_navigation_link( array( 'title' => 'カスタムリンク', 'category' => 'widgets', 'icon' => 'admin-links' ) );

例2: 説明付きのリンクブロック

ブロックに説明を追加して、より詳細な情報を提供します。

register_block_core_navigation_link( array( 'title' => '詳細リンク', 'description' => 'これはカスタムリンクブロックです。', 'category' => 'widgets' ) );

例3: カスタムアイコンを使用したリンクブロック

ブロックにカスタムアイコンを設定します。

register_block_core_navigation_link( array( 'title' => 'アイコン付きリンク', 'icon' => 'star-filled', 'category' => 'widgets' ) );

例4: キーワードを使用したリンクブロック

ブロックを検索しやすくするためにキーワードを追加します。

register_block_core_navigation_link( array( 'title' => '検索用リンク', 'keywords' => array( 'リンク', 'ナビゲーション', 'カスタム' ), 'category' => 'widgets' ) );

例5: 複数のカテゴリーにリンクブロックを登録

ブロックを複数のカテゴリーに登録します。

register_block_core_navigation_link( array( 'title' => '多機能リンク', 'category' => array( 'widgets', 'design' ), 'icon' => 'admin-site' ) );

例6: カスタム属性を持つリンクブロック

ブロックにカスタム属性を追加します。

register_block_core_navigation_link( array( 'title' => '属性付きリンク', 'attributes' => array( 'url' => array( 'type' => 'string' ), 'category' => 'widgets' ) );

例7: デフォルト値を持つリンクブロック

ブロックにデフォルト値を設定します。

register_block_core_navigation_link( array( 'title' => 'デフォルトリンク', 'attributes' => array( 'url' => array( 'type' => 'string', 'default' => 'https://example.com' ), 'category' => 'widgets' ) );

注意点

  • この関数は、ブロックエディタが有効な場合にのみ使用できます。
  • 引数の配列は正確に設定する必要があります。誤った設定はブロックの登録に失敗する原因となります。

関連機能：