acf_get_select_input()


Advanced Custom Fields (ACF) プラグインの関数 acf_get_select_input() は、選択フィールドの入力を取得するために使用されます。この関数は特にカスタムフィールドの値やオプションの取得に便利です。

シンタックス

acf_get_select_input( array $args = array() );

引数の説明:

  • $args (array) — 入力オプションを設定するための配列。
  • 'choices' (array) — 選択肢を含む配列。
  • 'value' (mixed) — 現在の選択値。
  • 'class' (string) — 入力に追加するカスタムクラス。
  • 'id' (string) — 入力の識別子。

例 1: 基本的な選択入力の生成

以下の例は、基本的な選択入力を生成します。

<?php 
acf_get_select_input( array(
    'choices' => array( 'Option 1', 'Option 2', 'Option 3' ),
    'value'   => 'Option 2',
) ); 
?>

例 2: カスタムクラス付きの選択入力

入力にカスタムクラスを追加します。

<?php 
acf_get_select_input( array(
    'choices' => array( 'Red', 'Blue', 'Green' ),
    'value'   => 'Blue',
    'class'   => 'custom-class',
) ); 
?>

例 3: ID属性の指定

選択入力に特定のIDを設定します。

<?php 
acf_get_select_input( array(
    'choices' => array( 'Apple', 'Banana', 'Cherry' ),
    'value'   => 'Banana',
    'id'      => 'fruit-selector',
) ); 
?>

例 4: 選択肢が動的に生成される場合

選択肢をデータベースや関数から動的に生成します。

<?php 
$dynamic_choices = get_categories( array( 'fields' => 'names' ) );
acf_get_select_input( array(
    'choices' => $dynamic_choices,
    'value'   => 'Category 1',
) ); 
?>

例 5: 値の保存後の表示

保存された値を取得して表示する場合。

<?php 
$saved_value = get_field( 'my_select_field' );
acf_get_select_input( array(
    'choices' => array( 'Option A', 'Option B', 'Option C' ),
    'value'   => $saved_value,
) ); 
?>

注意事項

  • acf_get_select_input() を使用する前に ACF プラグインがインストールされていることを確認してください。
  • カスタムフィールドのキーが正しいかどうかを必ず確認してください。
  • この関数は主にテーマやプラグイン開発者向けに設計されています。