acf_get_radio_input()


WordPressのacf_get_radio_input()関数は、ラジオボタンのHTML入力要素を生成するために使用されます。この関数はAdvanced Custom Fields(ACF)プラグインで利用可能です。

シンタックス

acf_get_radio_input( array $args );
  • $args (array) — ラジオボタンをカスタマイズするための設定配列。

引数内のキー:

  • choices (array) — 選択肢のキーとラベルをペアとして指定します。
  • value (string) — 現在選択されている値を指定します。
  • name (string) — ラジオボタンのname属性を指定します。
  • class (string) — ラジオボタン要素に適用されるCSSクラスを指定します。

例 1: シンプルなラジオボタンの生成

以下は、基本的なラジオボタンを生成する例です。

<?php
echo acf_get_radio_input( array(
    'choices' => array( 'yes' => 'はい', 'no' => 'いいえ' ),
    'name'    => 'example_radio',
    'value'   => 'yes',
) );
?>

例 2: 現在の値を表示

現在選択されている値を動的に設定します。

<?php
$current_value = get_option( 'selected_radio_value' );
echo acf_get_radio_input( array(
    'choices' => array( 'one' => '1', 'two' => '2', 'three' => '3' ),
    'name'    => 'dynamic_radio',
    'value'   => $current_value,
) );
?>

例 3: CSSクラスを追加

特定のCSSクラスをラジオボタンに適用します。

<?php
echo acf_get_radio_input( array(
    'choices' => array( 'a' => '選択A', 'b' => '選択B' ),
    'name'    => 'styled_radio',
    'class'   => 'custom-class',
) );
?>

例 4: 投稿データに基づく選択肢の生成

投稿データに基づいて選択肢を動的に生成します。

<?php
$posts = get_posts( array( 'post_type' => 'post', 'numberposts' => 5 ) );
$choices = array();
foreach ( $posts as $post ) {
    $choices[ $post->ID ] = $post->post_title;
}
echo acf_get_radio_input( array(
    'choices' => $choices,
    'name'    => 'post_radio',
) );
?>

例 5: カスタム設定でラジオボタンを表示

カスタム設定を使用してラジオボタンを表示します。

<?php
echo acf_get_radio_input( array(
    'choices' => array( 'true' => '真', 'false' => '偽' ),
    'name'    => 'boolean_radio',
    'value'   => 'false',
    'class'   => 'boolean-class',
) );
?>