Visualforce 開発者ガイド
japex:form
ユーザーが入力を行ってから、<apex:commandButton> または <apex:commandLink> を使用して送信できる Visualforce ページのセクションです。フォームの本文で、表示されるデータおよびその処理方法を特定します。1 つのページまたはカスタムコンポーネントで 1 つの <apex:form> タグのみを使用するためのベストプラクティスです。
このコンポーネントを使用して、sObject の項目に対応しないコントローラーメソッドのユーザー入力を取得します。sObject 項目で使用できるのは、<apex:inputField> と <apex:outputField> のみです。
API バージョン 18.0 では、このタグは <apex:repeat> の子コンポーネントにすることはできません。
このコンポーネントでは、「html-」プレフィックスを使用した HTML パススルー属性がサポートされています。パススルー属性は、生成された <form> タグに適用されます。
例
1<!-- For this example to render properly, you must associate the Visualforce page
2with a valid case record in the URL.
3For example, if 001D000000IRt53 is the case 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
8<apex:page standardController="Case" recordSetVar="cases" tabstyle="case">
9 <apex:form id="changeStatusForm">
10 <apex:pageBlock >
11 <apex:pageMessages />
12 <apex:pageBlockButtons>
13 <apex:commandButton value="Save" action="{!save}"/>
14 </apex:pageBlockButtons>
15 <apex:pageBlockTable value="{!cases}" var="c">
16 <apex:column value="{!c.casenumber}"/>
17 <apex:column value="{!c.account.name}"/>
18 <apex:column value="{!c.contact.name}"/>
19 <apex:column value="{!c.subject}"/>
20 <apex:column headerValue="Status">
21 <apex:inputField value="{!c.Status}"/>
22 </apex:column>
23 </apex:pageBlockTable>
24 </apex:pageBlock>
25 </apex:form>
26</apex:page>上述の例では次の HTML を表示します。
1<!-- allows you to change the status of your cases -->
2<form id="j_id0:changeStatusForm" 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:changeStatusForm:j_id1:j_id29" class="pbButton">
9 <input type="submit"
10 name="j_id0:changeStatusForm: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="5"/>
19 <thead>
20 <tr class="headerRow ">
21 <th class="headerRow " scope="col">Case Number</th>
22 <th class="headerRow " scope="col">Account Name</th>
23 <th class="headerRow " scope="col">Name</th>
24 <th class="headerRow " scope="col">Subject</th>
25 <th class="headerRow " scope="col">Status</th>
26 </tr>
27 </thead>
28
29 <tbody>
30 <tr class="dataRow even first ">
31 <td class="dataCell"><span>00001000</span></td>
32 <td class="dataCell"><span>Edge Communications</span></td>
33 <td class="dataCell"><span>Rose Gonzalez</span></td>
34 <td class="dataCell"><span>Starting generator after electrical failure</span></td>
35 <td class="dataCell">
36 <select>
37 <option value="">--None--</option>
38 <option value="New">New</option>
39 <option value="Working" selected="selected">Working</option>
40 <option value="Escalated">Escalated</option>
41 <option value="Closed">Closed</option>
42 </select>
43 </td>
44 </tr>
45
46 <tr class="dataRow odd last ">
47 <td class="dataCell"><span>00001027</span></td>
48 <td class="dataCell"><span>Joyce Bookings</span></td>
49 <td class="dataCell"><span>Andy Young</span></td>
50 <td class="dataCell"><span>Checking paper jam</span></td>
51 <td class="dataCell">
52 <select>
53 <option value="">--None--</option>
54 <option value="New">New</option>
55 <option value="Working" selected="selected">Working</option>
56 <option value="Escalated">Escalated</option>
57 <option value="Closed">Closed</option>
58 </select>
59 </td>
60 </tr>
61 </tbody>
62 </table>
63 </div>
64 <!-- closing div tags -->
65</form>属性
| 属性名 | 属性型 | 説明 | 必���かどうか | API バージョン | 通用範囲 |
|---|---|---|---|---|---|
| accept | String | このフォームを処理するサーバーが扱えるコンテンツタイプのカンマ区切りのリスト。この属性に可能な値には、「text/html」、「image/png」、「image/gif」、「video/mpeg」、「text/css」、および「audio/basic」などがあります。使用できる値の完全なリストなど、詳細は、W3C 仕様を参照してください。 | 10.0 | グローバル | |
| acceptcharset | String | このフォームを処理するサーバーが扱える文字符号化のカンマ区切りのリスト。指定されていない場合、この値はデフォルトの「UNKNOWN」に設定されます。 | 10.0 | グローバル | |
| dir | String | 生成された HTML コンポーネントの読み取り方向。可能な値には「RTL」 (右から左) または「LTR」 (左から右) などがあります。 | 10.0 | グローバル | |
| enctype | String | サーバーへのフォームの送信に使用されるコンテンツタイプ。指定されていない場合、この値はデフォルトの「application/x-www-form-urlencoded」に設定されます。 | 10.0 | グローバル | |
| forceSSL | Boolean | ページ自体が SSL を使用して提供されたかどうかには関係なく、SSL を使用してフォームが送信される。デフォルトは false です。値が false である場合、フォームは同じプロトコルを使用してページとして送信されます。forceSSL が true に設定されている場合、フォームの送信時には返されるページは SSL を使用します。 | 14.0 | ||
| id | String | ページの他のコンポーネントがフォームコンポーネントを参照できるようにする識別子。 | 10.0 | グローバル | |
| lang | String | 「en」または「en-US」など、生成された HTML 出力の基本言語。この属性についての詳細は、W3C 仕様を参照してください。 | 10.0 | グローバル | |
| onclick | String | onclick イベントが発生した場合 (ユーザーがフォームをクリックした場合) に呼び出される JavaScript。 | 10.0 | グローバル | |
| ondblclick | String | ondblclick イベントが発生した場合 (ユーザーがフォームをダブルクリックした場合) に呼び出される 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 | グローバル | |
| onreset | String | onreset イベントが発生した場合 (ユーザーがフォームの [リセット] ボタンをクリックした場合) に呼び出される JavaScript。 | 10.0 | グローバル | |
| onsubmit | String | onsubmit イベントが発生した場合 (ユーザーがフォームの [送信] ボタンをクリックした場合) に呼び出される JavaScript。 | 10.0 | グローバル | |
| prependId | Boolean | clientid 生成プロセス時にこのフォームがその子コンポーネントの ID の前にフォームの ID を追加するかどうかを指定する boolean 値。指定されていない場合、この値はデフォルトの true に設定されます。 | 10.0 | グローバル | |
| rendered | Boolean | コンポーネントをページに表示するかどうかを指定する boolean 値。指定されていない場合、この値はデフォルトの true に設定されます。 | 10.0 | グローバル | |
| style | String | フォームコンポーネントの表示に使用されるスタイル。主に、インライン CSS スタイルを追加するために使用されます。 | 10.0 | グローバル | |
| styleClass | String | フォームコンポーネントの表示に使用されるスタイルクラス。主に、外部 CSS スタイルシートを使用するときに適用される CSS スタイルを指定するために使用されます。 | 10.0 | グローバル | |
| target | String | フォームの送信後にレスポンスを表示するフレームの名前。この属性に可能な値には、「_blank」、「_parent」、「_self」、「_top」などがあります。また、目的の移行先の name 属性に値を割り当てることにより、独自の移行先名を指定することもできます。 | 10.0 | グローバル | |
| title | String | ユーザーがコンポーネントにマウスポインターを重ねたときにツールチップとして表示されるテキスト。 | 10.0 | グローバル |