<af:clientListener>

clientListener client listener


clientListenerタグは、特定のイベント・タイプの起動時に実行される、クライアント側のリスナー・スクリプトを登録する宣言的方法です。このタグはリッチ・クライアントのコンポーネントでのみサポートされているため、サーバーでレンダリングされたコンポーネントには無視されます。

clientListenerタグを使用する前に、スクリプトを不要にする可能性がある動作タグが存在しないか、必ず検索してください。たとえば、af:showPopupBehaviorタグでは、ポップアップの表示に必要な処理が簡素化されます。

例:

この例では、ボタンをクリックして手動でポップアップを表示すると、JavaScriptのメソッドであるshowPopupFromActionが起動します。

<source>
<f:verbatim><![CDATA[
/**
 * Shows a popup from an "action" type event.
 * @param {AdfActionEvent} actionEvent the event being handled
 */
function showPopupFromAction(actionEvent)
{
  actionEvent.cancel();
  var eventSource = actionEvent.getSource();
  var popup = eventSource.findComponent("popup");
  popup.show({align:AdfRichPopup.ALIGN_AFTER_START, alignId:eventSource.getClientId()});
}
]]></f:verbatim>

<af:popup id="popup" contentDelivery="immediate">
  <af:panelGroupLayout layout="vertical" inlineStyle="width: 300px;">
    <af:outputText value="Hello World."/>
  </af:panelGroupLayout>
</af:popup>

<af:commandButton text="Click Me">
  <af:clientListener type="action" method="showPopupFromAction"/>
</af:commandButton>

</source>

イベント・タイプ

次の表には、コンポーネント・ファミリ特有のイベント・タイプをリスト表示します。

イベント・タイプ コンポーネント・ファミリ 説明
action Command ユーザーがコマンド・コンポーネントをトリガーしたときに起動します。
dialog Dialog ユーザーがダイアログの「OK」ボタンまたは「取消」ボタンをクリックしたときに起動します。
disclosure ShowDetail 開示状態が切り替えられたときに起動します。
load Document ドキュメントのロードが終了したときに起動します。
popupOpening Popup ポップアップが開く前に起動します。
popupOpened Popup ポップアップが開いた後で起動します。
popupClosed Popup ポップアップが閉じた後で起動します。
query Query 問合せアクションが発生したとき(ユーザーがquickQueryで検索アイコンをクリックするか、問合せコンポーネントで検索ボタンをクリックしたとき)に起動します。
rowDisclosure Tree、TreeTable 行の開示状態が切り替えられたときに起動します。
selection Table、Tree、TreeTable 選択状態が変化したときに起動します。
sort Table ユーザーがデータをソートしたときに起動します。
valueChange Input、Select* 入力制御の値が変化したときに起動します。

次の表には入力(マウス/キーボード)のイベント・タイプをリスト表示します。これらのイベントはすべてのコンポーネントに配信されます(ただし特定のコンポーネントの実装により、イベントが使用される場合、またはブロックされる場合があります)。

イベント・タイプ 説明
click ユーザーがコンポーネントをクリックすると、起動します。
dblClick ユーザーがコンポーネントをダブルクリックすると、起動します。
contextMenu ユーザーが右のマウスボタンでコンポーネントをクリックすると、起動します。
mouseDown ユーザーがコンポーネントに対してマウス・ボタンを押した状態にすると、起動します。
mouseUp ユーザーがコンポーネントに対してマウスアップすると、起動します。
mouseMove ユーザーがコンポーネント上でマウスを動かすと、起動します。
mouseOver マウスがコンポーネント上に移動すると、起動します。
mouseOut マウスがコンポーネントから外れると、起動します。
keyDown コンポーネントをフォーカスした状態でユーザーがキーを押すと、起動します。
keyUp コンポーネントをフォーカスした状態でユーザーがキーを押すのを止めると、起動します。
keyPress コンポーネントをフォーカスした状態でキーを正しく押すと、起動します。
focus キーボードを使用してコンポーネントをフォーカスすると、起動します。
blur キーボードを使用してコンポーネントからフォーカスを外すと、起動します。

属性

名前 ELのサポート 説明
type String なし リスニングする、クライアント側のコンポーネントのイベント・タイプ
method String なし 指定タイプのイベントでトリガーされると起動する、クライアント側のjavascriptメソッドtype