JWL get アクションが (例えば、ボタン・クリックの結果として) このコンポーネントの親パネルに対して実行されるときには、 クライアントはパネルの代替コンテンツを要求し、代替コンテンツが使用可能な場合には、 既存のパネルのコンテンツを新規コンテンツで置き換えます。 このパネルを含むページは get によっては置き換えられません。このタグがあると、 ページの「一部」を置き換えることができます。 改訂されたページのコンテンツは、オリジナル・コンテンツの元になったものと同じ JSP から取得されます。 ページの、サーバーのライフ・サイクル・コピーとクライアント・サイド・ページは、ともに同期して保持されます。 新規ページのコンテンツは、get HTTP 要求操作を使用して取得されます (これに対し、ajaxRefreshSubmit では、post HTTP 要求を使用して同じ操作が行われます)。get が実行されると、コンテンツを正しく算出するためにサーバーで必要な値がパラメーターとして URL に追加されます。
<factory> <faces-context-factory> com.ibm.faces.context.AjaxFacesContextFactory </faces-context-factory> <render-kit-factory> com.ibm.faces.renderkit.AjaxRenderKitFactory </render-kit-factory> </factory>
<h:panelGroup id="panel1"> <hx:ajaxRefreshRequest onerror="return doError(this, event);"/> </h:panelGroup>
<h:outputText id="otext2" escape="false" rendered="#{param.text1 != null}" value="You typed:<b> #{param.text1}</b>"/>
<hx:ajaxRefreshRequest onerror="return doError(this, event);" params="text1"/>
<hx:commandExButton type="button" value="Enter" id="button1"> <hx:behavior event="onclick" behaviorAction="get;stop" targetAction="panel1"/> </hx:commandExButton>
コンポーネントの「プロパティー」ビューには、 コンポーネントに設定できる最も一般的な属性のセットが表示されます。 コンポーネントによっては、制御、アクション、 または他のコンポーネントの追加に関するオプションが 表示される場合もあります。 「プロパティー」ビューを開くには、
とクリックします。「コンテンツの取得」コンポーネントの共通属性を次の表にリストします。
「すべての属性」ビューには、コンポーネントで設定できるすべての属性の表が表示されます。
この表には、「プロパティー」ビューからアクセスできる属性も含まれます。
「すべての属性」ビューに切り替えるには、
「プロパティー」ビューの右上隅にある「すべての属性」アイ
コンをクリックします。
属性名 |
説明 |
---|---|
binding |
コンポーネントの インスタンス (通常はユーザー・インターフェース・ コンポーネント) を、Bean プロパティー (通常は バッキング・ファイル内にあります) にバインドする式です。 |
id |
コンポーネントに名前を割り当てます。JSP 内で固有の名前にする必要があります。 |
inProgress |
属性はまだ使用可能になっていません。 |
rendered |
true または false に設定できます。
|
params |
これらのタグの値は検索され、新コンテンツの取得に使用される URL のパラメーターとして付加されます。 提供される単純な ID が、このパラメーターの名前になります。 例えば、ID が「text1」である場合、 パラメーターの名前は「text1」に なります (「form1:text1」にはなりません)。 |
target |
ハイパーリンクがクリックされたときにページがロードされる、
フレームセット内のターゲット・フレームを割り当てます。
|
title |
実行時にツールチップとしてブラウザーに表示される、タイトル・テキストを指定します。 コンポーネントの代替テキストが指定されていない場合、 ブラウザーはこのテキストを代替テキストとして使用します。 |
oncomplete |
要求が成功した場合、 パネルの内容を置換した後で、 ここで指定する JavaScript™ を 実行します。 この関数には、有効な引数がありません。 |
onerror |
onblur が起動して、 フィールド値の妥当性検査が失敗した場合に 実行される JavaScript 関数 (指定 する場合)。 この関数は、アクションが実行される前に実行されます。関数が false を返す場合、アクションは実行されず、イベントの処理は (DOM によって停止される場合) 停止されます。 |
onstart |
振る舞いが開始される際に、 この JavaScript 関数が 実行されます。 この関数には、有効な引数がありません。false を返す場合、実行は停止します。この関数を oncomplete と併せて使用すると、要求の進行中に表示される内容をカスタマイズできます。 |