wc_dropdown_variation_attribute_options()


WordPressの関数wc_dropdown_variation_attribute_options()は、WooCommerceの商品ページで属性オプションのドロップダウンを表示するために使用されます。

構文

wc_dropdown_variation_attribute_options( array $args );

引数の説明:

  • $args (array) — ドロップダウンの設定を指定する引数の配列。
  • 'options' (array) — ドロップダウンのオプション値のリスト。
  • 'attribute' (string) — 表示する属性名。
  • 'product' (WC_Product) — 現在の商品のインスタンス。
  • 'selected' (string) — 初期選択されるオプション。
  • 'name' (string) — <select>要素のname属性。
  • 'id' (string) — <select>要素のid属性。
  • 'class' (string) — <select>要素のクラス名。

使用例:

例 1: 商品属性ドロップダウンの基本表示

商品属性の選択肢を基本的に表示します。

wc_dropdown_variation_attribute_options( array(
    'attribute' => 'pa_color',
    'product'   => wc_get_product(),
) );

例 2: 選択済みのオプションを設定

初期状態で特定のオプションを選択します。

wc_dropdown_variation_attribute_options( array(
    'attribute' => 'pa_size',
    'product'   => wc_get_product(),
    'selected'  => 'large',
) );

例 3: 独自のname属性とid属性を指定

<select>要素にカスタム属性を設定します。

wc_dropdown_variation_attribute_options( array(
    'attribute' => 'pa_material',
    'product'   => wc_get_product(),
    'name'      => 'custom_material',
    'id'        => 'custom_material_id',
) );

例 4: カスタムクラスを追加

ドロップダウンにカスタムクラスを適用します。

wc_dropdown_variation_attribute_options( array(
    'attribute' => 'pa_color',
    'product'   => wc_get_product(),
    'class'     => 'custom-dropdown-class',
) );

例 5: オプションリストを手動で指定

オプションを手動で指定し、表示をカスタマイズします。

wc_dropdown_variation_attribute_options( array(
    'options'   => array( 'red', 'blue', 'green' ),
    'attribute' => 'pa_custom',
    'product'   => wc_get_product(),
) );

注意点

この関数を使用する際、正しい商品インスタンスを渡し、必要な属性が商品に登録されていることを確認してください。属性が不正または欠落している場合、ドロップダウンは正しく動作しない可能性があります。

関連機能：