apex:inputCheckbox
checkbox 型の HTML 入力要素です。このコンポーネントを使用して、Salesforce オブジェクトの項目に対応しないコントローラメソッドのユーザ入力を取得します。
このコンポーネントを使用して、sObject の項目に対応しないコントローラメソッドのユーザ入力を取得します。sObject 項目で使用できるのは、<apex:inputfield> と apex:outfield のみです。
このコンポーネントでは、「html-」プレフィックスを使用した HTML パススルー属性がサポートされています。パススルー属性は、生成された <input> タグに適用されます。
例
上述の例では次の HTML を表示します。
属性
| 属性名 | 属性型 | 説明 | 必須かどうか | API バージョン | 通用範囲 |
|---|---|---|---|---|---|
| accesskey | String | チェックボックスにフォーカスを置くキーボードのアクセスキー。チェックボックスにフォーカスが置かれている場合は、ユーザがチェックボックスの値を選択または選択解除できます。 | 10.0 | グローバル | |
| dir | String | 生成された HTML コンポーネントの読み取り方向。使用可能な値には「RTL」 (右から左) または「LTR」 (左から右) があります。 | 10.0 | グローバル | |
| disabled | Boolean | このチェックボックスを無効な状態で表示するかどうかを指定する boolean 値。true に設定されている場合、チェックボックスは無効な状態で表示されます。指定されていない場合、この値はデフォルトの false に設定されます。 | 10.0 | グローバル | |
| id | String | ページの他のコンポーネントがチェックボックスコンポーネントを参照できるようにする識別子。 | 10.0 | グローバル | |
| immediate | Boolean | ページの項目に関連付けられている入力規則を処理することなく、このコンポーネントに関連付けられているアクションをすぐに実行するかどうかを指定する boolean 値。true に設定すると、アクションがすぐに実行され、入力規則はスキップされます。指定されていない場合、この値はデフォルトの false に設定されます。 | 11.0 | グローバル | |
| label | String | コントロールの横に表示ラベルを表示し、エラーメッセージ内のコントロールを参照できるようにするテキスト値。 | 23.0 | ||
| lang | String | 「en」または「en-US」など、生成された HTML 出力の基本言語。この属性についての詳細は、W3C 仕様を参照してください。 | 10.0 | グローバル | |
| onblur | String | onblur イベントが発生した場合 (フォーカスがチェックボックスから離れた場合) に呼び出される JavaScript。 | 10.0 | グローバル | |
| onchange | String | onchange イベントが発生した場合 (ユーザがチェックボックス項目のコンテンツを変更した場合) に呼び出される JavaScript。 | 10.0 | グローバル | |
| onclick | String | onclick イベントが発生した場合 (ユーザがチェックボックスをクリックした場合) に呼び出される JavaScript。 | 10.0 | グローバル | |
| ondblclick | String | ondblclick イベントが発生した場合 (ユーザがチェックボックスをダブルクリックした場合) に呼び出される JavaScript。 | 10.0 | グローバル | |
| onfocus | String | onfocus イベントが発生した場合 (フォーカスがチェックボックスにある場合) に呼び出される JavaScript。 | 10.0 | グローバル | |
| onkeydown | String | onkeydown イベントが発生した場合 (ユーザがキーボードのキーを押した場合) に呼び出される JavaScript。 | 10.0 | グローバル | |
| onkeypress | String | onkeypress イベントが発生した場合 (ユーザがキーボードのキーを押したか、押したままにした場合) に呼び出される JavaScript。 | 10.0 | グローバル | |
| onkeyup | String | onkeyup イベントが発生した場合 (ユーザがキーボードのキーを放した場合) に呼び出される JavaScript。 | 10.0 | グローバル | |
| onmousedown | String | onmousedown イベントが発生した場合 (ユーザがマウスボタンをクリックした場合) に呼び出される JavaScript。 | 10.0 | グローバル | |
| onmousemove | String | onmousemove イベントが発生した場合 (ユーザがマウスポインタを移動した場合) に呼び出される JavaScript。 | 10.0 | グローバル | |
| onmouseout | String | onmouseout イベントが発生した場合 (ユーザがチェックボックスからマウスポインタを移動した場合) に呼び出される JavaScript。 | 10.0 | グローバル | |
| onmouseover | String | onmouseover イベントが発生した場合 (ユーザがマウスポインタをチェックボックスに重ねた場合) に呼び出される JavaScript。 | 10.0 | グローバル | |
| onmouseup | String | onmouseup イベントが発生した場合 (ユーザがマウスボタンを放した場合) に呼び出される JavaScript。 | 10.0 | グローバル | |
| onselect | String | onselect イベントが発生した場合 (ユーザがチェックボックスを選択した場合) に呼び出される JavaScript。 | 10.0 | グローバル | |
| rendered | Boolean | コンポーネントをページに表示するかどうかを指定する boolean 値。指定されていない場合、この値はデフォルトの true に設定されます。 | 10.0 | グローバル | |
| required | Boolean | このチェックボックスが必須項目であるかどうかを指定する boolean 値。true に設定されている場合、このチェックボックスの値を指定する必要があります。選択されていない場合、この値はデフォルトの false に設定されます。 | 10.0 | グローバル | |
| selected | Boolean | このチェックボックスを「オン」の状態で表示するかどうかを指定する boolean 値。選択されていない場合、この値はデフォルトの false に設定されます。 | 10.0 | グローバル | |
| style | String | inputCheckbox コンポーネントの表示に使用されるスタイル。主に、インライン CSS スタイルを追加するために使用されます。 | 10.0 | グローバル | |
| styleClass | String | inputCheckbox コンポーネントの表示に使用されるスタイルクラス。主に、外部 CSS スタイルシートを使用するときに適用される CSS スタイルを指定するために使用されます。 | 10.0 | グローバル | |
| tabindex | String | ユーザが Tab キーを繰り返し押したときに、他のページコンポーネントと比較して、このチェックボックスが選択される順序。この値は、ユーザが Tab キーを押したときに選択される最初のコンポーネントを 0 として、0 ~ 32767 の整数である必要があります。 | 10.0 | グローバル | |
| title | String | ユーザがコンポーネントにマウスポインタを重ねたときにツールチップとして表示されるテキスト。 | 10.0 | グローバル | |
| value | Object | このチェックボックスに関連付けられているコントローラクラス変数を参照する差し込み項目。たとえば、コントローラクラスの関連付けられている変数の名前が myCheckbox である場合、この変数を参照するには value="{!myCheckbox}" を使用します。 | 10.0 | グローバル |