disabled()

WordPressのdisabled()関数は、フォーム要素を無効化するために使用されます。この関数は、指定された条件が真の場合にHTML属性disabledを出力します。

構文

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

引数の説明:

• $disabled (mixed) — 無効化する条件を指定します。この値が$currentと一致する場合、disabled属性が出力されます。
• $current (mixed) — 現在の値を指定します。デフォルトはtrueです。
• $echo (bool) — disabled属性を出力するかどうかを指定します。trueの場合、出力されます。falseの場合、戻り値として返されます。

例1: 基本的な使用法

この例では、$disabledがtrueの場合、ボタンが無効化されます。

<button <?php disabled(true, true); ?>>クリック不可</button>

例2: 条件付き無効化

$disabledが$currentと一致する場合、ボタンが無効化されます。

<button <?php disabled($post->post_status, 'publish'); ?>>公開済み</button>

例3: 戻り値の取得

$echoをfalseに設定して、disabled属性を出力せずに戻り値として取得します。

<?php $disabled_attr = disabled(true, true, false); ?>
<button <?php echo $disabled_attr; ?>>クリック不可</button>

例4: チェックボックスの無効化

チェックボックスを無効化する例です。

<input type="checkbox" <?php disabled(true, true); ?>>

例5: セレクトボックスの無効化

セレクトボックスを無効化する例です。

<select <?php disabled(true, true); ?>><option>選択肢</option></select>

例6: ラジオボタンの無効化

ラジオボタンを無効化する例です。

<input type="radio" <?php disabled(true, true); ?>>

例7: テキスト入力欄の無効化

テキスト入力欄を無効化する例です。

<input type="text" <?php disabled(true, true); ?>>

例8: 複数の条件を指定

複数の条件を指定して、いずれかが一致する場合に無効化します。

<button <?php disabled(in_array($post->post_status, array('draft', 'pending')), true); ?>>下書きまたは保留中</button>

注意点

• disabled属性が適用された要素は、ユーザーが操作できなくなります。
• $echoをfalseに設定した場合、disabled属性は出力されず、戻り値として返されるため、手動で出力する必要があります。