build_variation_for_navigation_link()


WordPressのbuild_variation_for_navigation_link()関数は、ナビゲーションメニューのリンクに対してカスタムバリエーションを生成するために使用されます。この関数は、リンクのスタイルや動作を動的に変更する際に役立ちます。

構文

build_variation_for_navigation_link( array $args );

引数の説明:

  • $args(array) — ナビゲーションリンクのバリエーションを定義するための引数。以下のキーを持つ連想配列です。
    • 'link_text'(string) — リンクに表示するテキスト。
    • 'link_url'(string) — リンクのURL。
    • 'link_class'(string) — リンクに適用するCSSクラス。
    • 'link_attrs'(array) — リンクに追加するHTML属性。

例1: 基本的なナビゲーションリンクの作成

この例では、シンプルなナビゲーションリンクを作成します。

$args = array('link_text' => 'ホーム', 'link_url' => home_url()); echo build_variation_for_navigation_link($args);

例2: CSSクラスを追加したリンク

この例では、CSSクラスを追加してリンクのスタイルを変更します。

$args = array('link_text' => 'ブログ', 'link_url' => get_permalink(get_option('page_for_posts')), 'link_class' => 'custom-link'); echo build_variation_for_navigation_link($args);

例3: カスタム属性を追加したリンク

この例では、リンクにカスタム属性を追加します。

$args = array('link_text' => 'お問い合わせ', 'link_url' => get_permalink(2), 'link_attrs' => array('target' => '_blank')); echo build_variation_for_navigation_link($args);

例4: アイコン付きリンク

この例では、リンクテキストにアイコンを追加します。

$args = array('link_text' => '<i class="fas fa-home"></i> ホーム', 'link_url' => home_url()); echo build_variation_for_navigation_link($args);

例5: 外部リンクの作成

この例では、外部サイトへのリンクを作成します。

$args = array('link_text' => 'Google', 'link_url' => 'https://google.com', 'link_attrs' => array('target' => '_blank', 'rel' => 'noopener')); echo build_variation_for_navigation_link($args);

例6: 現在のページにアクティブクラスを追加

この例では、現在のページにアクティブクラスを追加します。

$args = array('link_text' => '現在のページ', 'link_url' => get_permalink(), 'link_class' => 'active'); echo build_variation_for_navigation_link($args);

例7: ダウンロードリンクの作成

この例では、ファイルのダウンロードリンクを作成します。

$args = array('link_text' => 'PDFをダウンロード', 'link_url' => get_template_directory_uri() . '/files/document.pdf', 'link_attrs' => array('download' => 'document.pdf')); echo build_variation_for_navigation_link($args);

注意点

  • この関数を使用する際は、$args配列のキーが正しく設定されていることを確認してください。
  • リンクのURLが存在しない場合、エラーが発生する可能性があります。
  • HTML属性を追加する際は、セキュリティに注意してください。

関連機能：