この文章は Salesforce 機械翻訳システムを使用して翻訳されました。詳細はこちらをご参照ください。

非同期操作のための状況の提供

部分ページ更新などの 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」というファセット (この例では詳細領域) をサポートします。

1<apex:page standardController="Account">
2    <apex:pageBlock title="Hello {!$User.FirstName}!">
3        You are displaying contacts from the {!account.name} account. 
4        Click a contact's name to view his or her details.
5    </apex:pageBlock>
6    <apex:pageBlock title="Contacts">
7        <apex:form>
8            <apex:dataTable value="{!account.Contacts}" var="contact" cellPadding="4" 
9                               border="1">
10                  <apex:column>
11                      <apex:commandLink rerender="detail">
12                          {!contact.Name}
13                          <apex:param name="cid" value="{!contact.id}"/>
14                      </apex:commandLink>
15                  </apex:column>
16            </apex:dataTable>
17        </apex:form>
18    </apex:pageBlock>
19    <apex:outputPanel id="detail">
20        <apex:actionStatus startText="Requesting...">
21            <apex:facet name="stop"> 
22                <apex:detail subject="{!$CurrentPage.parameters.cid}" 
23                             relatedList="false" title="false"/>
24            </apex:facet>
25        </apex:actionStatus> 
26    </apex:outputPanel>
27</apex:page>

このページをアクセスするときに、ID を URL の一部として含めてください。次に例を示します。

1https://Salesforce_instance/apex/ajaxAsyncStatus?id=001x000xxx3Jsxb

Visualforce 開発者ガイド

非同期操作のための状況の提供