<hx:ajaxRefreshRequest>
イベント・ハンドラーをサポートする HTML タグの いずれかに付加される振る舞い (例えば、一般振る舞い) の 一部である、JWL GET アクションからのみ起動します。 GET のターゲットは、この振る舞いを 含む (または振る舞いのターゲットである) パネルの ID にする必要があります。
hX_5.addBehavior("id", "onget", new hX_5.JSFBehaviorAjaxGet(attributes)); 各部の意味は次のとおりです。
id |
コンポーネントが付加される HTML タグの ID。 |
属性 |
コンマで区切られた属性のリスト。 各属性は、属性名と値から成る引用符付きストリングになっており、 コロンで区切られています (例: "label:MyLabel")。 |
イベント |
説明 |
---|---|
onget |
特殊なイベント名の使用には注意してください。 この属性は必須です。 |
属性名 |
説明 |
---|---|
title |
要求の進行中に、 パネルのプライマリー・タグ (例えば div) と、 パネルに割り当てられた「一時的タブ停止位置」に、 そのタイトルが割り当てられます。 このタイトルは、 パネルにマウスオーバーしたときはツールチップとして表示され、 スクリーン・リーダーで使用することができます。 |
progress-actions |
要求の進行中に、パネルに適用される JWL アクション (複数可)。 現在サポートされているアクションは、LOCKED だけです。 |
params |
パラメーター名のリスト (セミコロン区切り)。 ページを検索するときに、 これらのパラメーター名と、param-fields で識別された 対応値とが組み込まれるように、URL がエンコードされます。 |
param-fields |
ID のパラレル・リスト (params が指定されている場合)。 ID で識別されたフィールドの値が、 パラメーター名の値として URL 内にエンコードされます。 リスト・パラメーターのサイズと param-fields のサイズは、 同じでなければなりません。 パラメーター名は、 通常はフィールドの非修飾 ID になります。 一方、対応する param-fields は、 通常はフィールドの「修飾」ID になります。 例えば、フィールド form1:text1 の値をエンコードする 場合は、text1 を param として使用し、 form1:text1 を param-fields として使用してください。 この結果、text1=value が URL 上でエンコードされます。 このとき、フィールド form1:text1 の 現行フィールドが value になります。 |
on-start |
要求の送信前に、 ここで指定する JavaScript™ 関数 が実行されます。 この関数に引数はありません。 false を返す場合、実行は停止します。この関数を oncomplete と併せて使用すると、要求の進行中に表示される内容をカスタマイズできます。 |
on-error |
要求が失敗/タイムアウトした場合に、 ここで指定する JavaScript が 実行されます。 シグニチャーは (thisObj,thisError) となります。thisObj は パネルを指し、thisError はエラーを記述するストリングを指します。 |
on-complete |
要求が成功した場合、 パネルの内容を置換した後で、 ここで指定する JavaScript を 実行します。 この関数には、有効な引数がありません。 |
on-start |
要求の送信前に、 ここで指定する JavaScript 関数 が実行されます。 この関数に引数はありません。 false を返す場合、実行は停止します。この関数を oncomplete と併せて使用すると、要求の進行中に表示される内容をカスタマイズできます。 |
「GET」が発行されたときに実行されます。 イベントを停止しません (「STOP」アクションは、 発生元の振る舞い内でエンコードされる必要があります)。
API 呼び出し |
説明 |
---|---|
object = setAttribute(attribute) |
属性を設定します。 属性がすでに設定されたものである場合は、 その値を変更します。 |
string = getAttribute(attribute-name) |
属性の現行値を取得します。 |
AJAX 検索を、ID「form1:panelHelp」を持つパネルに追加します。 コンテンツを検索する要求が行われるたびに、 フィールド「form1:lookUpText」の値を、 「lookupText」という名前のパラメーターとして エンコードします。
hX.addBehavior("form1:panelHelp", "onget", new hX.JSFBehaviorAjaxGet("on-error:return doError(this, event);", "params:lookUpText", "param-fields:form1:lookUpText", "on-start:return doPrep(this, event);"));