Visualforce 開発者ガイド
j非同期操作のための状況の提供
部分ページ更新などの Ajax 動作は、ページユーザが作業を進める間にバックグラウンドで発生する非同期イベントです。使い勝手をよくするために、デザイナーは、現在進行中のバックグラウンドのアクティビティについてユーザに警告する状況要素を追加することがよくあります。
Visualforce は、<apex:actionStatus> タグを使った状況更新をサポートしています。このタグを使用すると、startText または stopText 属性によって、バックグラウンドのイベントの開始時または終了時にテキストを表示できます。また、さらに上級の開発者であれば、画像やその他のコンポーネントを表示することができます。
この例では、取引先責任者リストのページに、開発段階であることを示す状況テキストを追加します。ユーザが取引先責任者の名前をクリックすると、詳細領域が表示される間、その領域に [要求中...] というテキストが表示されます。
メッセージを実装するには、<apex:actionStatus> を非同期的に更新される <apex:detail> コンポーネントの周りにラップします。2 つのタグの間に、「stop」という名前の <apex:facet> タグを追加します。
ファセットは、コンポーネントに示されるデータに関するコンテキスト情報を提供する、Visualforce コンポーネント内の 1 つの領域のコンテンツで構成されます。たとえば、<apex:dataTable> はテーブルのヘッダー、フッター、キャプションのファセットをサポートしますが、<apex:column> は列のヘッダーまたはフッターのファセットのみをサポートします。<apex:facet> コンポーネントを使用すると、Visualforce コンポーネントのデフォルトのファセットを独自のコンテンツで上書きできます。ファセットの開始タグと終了タグ内で使用できるのは 1 つの子のみです。
次の例では、<apex:actionStatus> は、アクションが完了するとすぐに表示されるコンポーネントを含む、「stop」というファセット (この例では詳細領域) をサポートします。
このページをアクセスするときに、ID を URL の一部として含めてください。次に例を示します。