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 |