Visualforce 開発者ガイド
j標準リストコントローラーアクション
標準リストコントローラーでは action メソッドがサポートされます。action メソッドは、ユーザーがボタンをクリックしたり、ページ内のある領域にマウスポインターを移動したりするなどのページイベントが発生すると、ロジックまたはナビゲーションを実行します。
次のいずれかのタグの action 属性に {! } 表記を使用することによって、ページマークアップから action メソッドをコールします。
- <apex:commandButton> はアクションをコールするボタンを作成する
- <apex:commandLink> はアクションをコールするリンクを作成する
- <apex:actionPoller> は定期的にアクションをコールする
- <apex:actionSupport> は、別の名前つきのコンポーネントにイベント (「onclick」、「onmouseover」など) を作成し、アクションをコールする
- <apex:actionFunction> は、アクションをコールする新しい JavaScript 関数を定義する
- <apex:page> はページが読み込まれると、アクションをコールする
この表では、すべての標準リストコントローラーでサポートされる action メソッドについて説明します。これらのアクションは、action 属性が含まれる Visualforce コンポーネントに関連付けることができます。
| アクション | 説明 |
|---|---|
| save | 新しいレコードを挿入するか、変更された既存のレコードを更新します。この操作が完了した後、save アクションは、元のページ (わかっている場合) またはホームページにユーザーを戻します。 |
| quicksave | 新しいレコードを挿入するか、変更された既存のレコードを更新します。save アクションとは異なり、quicksave はユーザーを別のページにリダイレクトしません。 |
| list | ユーザーが filterId を指定していない場合は、PageReference オブジェクトに対して最近使用されたリスト検索条件に基づいて、標準リストページの PageReference オブジェクトを返します。 |
| cancel | 編集操作を中止します。この操作が完了した後、cancel アクションは、最初にユーザーが編集を呼び出したページにユーザーを戻します。 |
| first | セットにあるレコードの最初のページを表示します。 |
| last | セットにあるレコードの最後のページを表示します。 |
| next | セットにあるレコードの次のページを表示します。 |
| previous | セットにあるレコードの前のページを表示します。 |
この例では、ユーザーが、取引先レコードを表示するための検索条件を指定します。
1<apex:page standardController="Account" recordSetVar="accounts">
2 <apex:form>
3 <apex:selectList value="{!filterid}" size="1">
4 <apex:selectOptions value="{!listviewoptions}"/>
5 </apex:selectList>
6 <apex:commandButton value="Go" action="{!list}"/>
7 </apex:form>
8</apex:page>ページは、StandardSetController Apex クラスに基づく標準 Account リストコントローラーに関連付けられています。{!listviewoptions} 式は StandardSetController の getListViewOptions() メソッドをコールし、使用可能なリストビューに評価されます。ユーザーが選択するリストビューはコントローラーの filterId プロパティにバインドされます。filterId が変更されると、ページで使用できるレコードは検索条件に従って変更されます。このため、ユーザーが [Go] をクリックすると、標準リストページには、選択された検索条件で絞り込まれたレコードが表示されます。