Visualforce 開発者ガイド
japex:inputCheckbox
checkbox 型の HTML 入力要素です。このコンポーネントを使用して、Salesforce オブジェクトの項目に対応しないコントローラーメソッドのユーザー入力を取得します。
このコンポーネントを使用して、sObject の項目に対応しないコントローラーメソッドのユーザー入力を取得します。sObject 項目で使用できるのは、<apex:inputField> と <apex:outputField> のみです。
このコンポーネントでは、「html-」プレフィックスを使用した HTML パススルー属性がサポートされています。パススルー属性は、生成された <input> タグに適用されます。
例
1<!-- For this example to render properly, you must associate the Visualforce page
2with a valid opportunity record in the URL.
3For example, if 001D000000IRt53 is the opportunity ID, the resulting URL should be:
4https://Salesforce_instance/apex/myPage?id=001D000000IRt53
5See the Visualforce Developer's Guide Quick Start Tutorial for more information. -->
6
7<apex:page standardController="Opportunity" recordSetVar="opportunities" tabstyle="opportunity">
8 <apex:form id="changePrivacyForm">
9 <apex:pageBlock >
10 <apex:pageMessages />
11 <apex:pageBlockButtons>
12 <apex:commandButton value="Save" action="{!save}"/>
13 </apex:pageBlockButtons>
14
15 <apex:pageBlockTable value="{!opportunities}" var="o">
16 <apex:column value="{!o.name}"/>
17 <apex:column value="{!o.account.name}"/>
18 <apex:column headerValue="Private?">
19 <apex:inputCheckbox value="{!o.isprivate}"/>
20 </apex:column>
21 </apex:pageBlockTable>
22 </apex:pageBlock>
23 </apex:form>
24</apex:page>上述の例では次の HTML を表示します。
1<!-- allows you to change the privacy option of your opportunity -->
2<form id="j_id0:changePrivacyForm" name="j_id0:changeStatusForm" method="post"
3 action="/apex/sandbox" enctype="application/x-www-form-urlencoded">
4 <!-- opening div tags -->
5 <table border="0" cellpadding="0" cellspacing="0">
6 <tr>
7 <td class="pbTitle"> </td>
8 <td id="j_id0:changePrivacyForm:j_id1:j_id29" class="pbButton">
9 <input type="submit"
10 name="j_id0:changePrivacyForm:j_id1:j_id29:j_id30"
11 value="Save" class="btn"/>
12 </td>
13 </tr>
14 </table>
15
16 <div class="pbBody">
17 <table class="list" border="0" cellpadding="0" cellspacing="0">
18 <colgroup span="3"/>
19 <thead>
20 <tr class="headerRow ">
21 <th class="headerRow " scope="col">Opportunity Name</th>
22 <th class="headerRow " scope="col">Account Name</th>
23 <th class="headerRow " scope="col">Privacy?</th>
24 </tr>
25 </thead>
26
27 <tbody>
28 <tr class="dataRow even first ">
29 <td class="dataCell"><span>Burlington Textiles Weaving Plant Generator</span></td>
30 <td class="dataCell"><span>Burlington Textiles Corp of America</span></td>
31 <td class="dataCell"><input type="checkbox" name="j_id0:changePrivacyForm:j_id1:j_id31:0:j_id35" checked="checked" /></td>
32 </tr>
33
34 <tr class="dataRow odd last ">
35 <td class="dataCell"><span>Edge Emergency Generator</span></td>
36 <td class="dataCell"><span>Edge Communications</span></td>
37 <td class="dataCell"><input type="checkbox" name="j_id0:changePrivacyForm:j_id1:j_id31:0:j_id35" checked="checked" /></td>
38 </tr>
39 </tbody>
40 </table>
41 </div>
42 <!-- closing div tags -->
43</form>属性
| 属性名 | 属性型 | 説明 | 必須かどうか | 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 | グローバル |