checked()


WordPressのchecked()関数は、主にフォーム要素で特定の値が一致するかを確認し、一致する場合にはchecked属性を返します。

構文

checked( mixed $checked, mixed $current, bool $echo = true );

引数の説明:

  • $checked (mixed) — 確認する値。
  • $current (mixed) — 比較対象の現在の値。
  • $echo (bool) — trueの場合、結果を直接出力します。デフォルトはtrue。

例1: 単純なチェックボックスの使用

以下のコードは、チェックボックスが選択された場合にchecked属性を追加します。

<input type="checkbox" name="example" value="1" <?php checked( 1, get_option( 'example_option' ) ); ?>>

例2: 複数選択肢のラジオボタン

ラジオボタンの選択肢が一致する場合にchecked属性を追加します。

<input type="radio" name="color" value="red" <?php checked( 'red', get_option( 'color_option' ) ); ?>>
<input type="radio" name="color" value="blue" <?php checked( 'blue', get_option( 'color_option' ) ); ?>>

例3: デフォルト値の設定

デフォルト値を設定する際に使用します。

<input type="checkbox" name="default" value="1" <?php checked( 1, get_option( 'default_option', 1 ) ); ?>>

例4: フィルター条件を使用したチェック

条件に基づいて動的に値を比較します。

<?php
$option = apply_filters( 'my_custom_filter', get_option( 'example_option' ) );
?>
<input type="checkbox" name="example" value="1" <?php checked( 1, $option ); ?>>

例5: 配列内の値をチェック

配列内に特定の値が含まれている場合にchecked属性を追加します。

<?php
$selected_options = get_option( 'selected_options', array() );
?>
<input type="checkbox" name="options[]" value="option1" <?php checked( in_array( 'option1', $selected_options ) ); ?>>
<input type="checkbox" name="options[]" value="option2" <?php checked( in_array( 'option2', $selected_options ) ); ?>>

注意事項

checked()関数を使用する際は、比較する値の型が一致していることを確認してください。特に、===演算子で厳密な型比較が行われることを理解しておく必要があります。

関連機能：