public interface ClientBehavior extends Behavior
ClientBehavior は、ClientBehaviorHolder
コンポーネントによって公開されるクライアント側のイベントにスクリプトコンテンツを添付する Behavior
の基本契約です。ClientBehavior
のインスタンスは、ClientBehaviorHolder.addClientBehavior(java.lang.String, javax.faces.component.behavior.ClientBehavior)
を呼び出すことにより、ClientBehaviorHolder
契約を実装するコンポーネントに接続できます。ClientBehavior
が ClientBehaviorHolder
コンポーネントに接続されると、コンポーネントは getScript(javax.faces.component.behavior.ClientBehaviorContext)
を呼び出して動作のスクリプトを取得し、コンポーネントはこれを適切なクライアント側のイベントハンドラーに接続します。このメソッドによって返されるスクリプトコンテンツは、常にインラインスクリプトコンテンツであることに注意してください。実装クラスが他のスクリプトリソースで定義された関数を呼び出す場合、実装クラスは ResourceDependency
または ResourceDependencies
アノテーションを使用する必要があります。
修飾子と型 | メソッドと説明 |
---|---|
void | decode(FacesContext context, UIComponent component) 指定された |
SetSE<ClientBehaviorHint> | getHints() ClientBehavior 実装の動作を説明するヒントを返します。 |
StringSE | getScript(ClientBehaviorContext behaviorContext) この ClientBehavior のクライアント側ロジックを実装するスクリプトを返します。 |
StringSE getScript(ClientBehaviorContext behaviorContext)
この ClientBehavior のクライアント側ロジックを実装するスクリプトを返します。
ClientBehavior.getScript() 実装は、この特定の getScript() 呼び出しにスクリプトが必要ないことを示すために null を返すことができます。例: 動作が無効になっている場合、ClientBehavior 実装は null を返す場合があります。
behaviorContext
- この getScript() 呼び出しに影響を与える可能性のあるプロパティを提供する ClientBehaviorContext
。ClientBehaviorContext インスタンスは、getScript() への呼び出しの間のみ有効な短期間のオブジェクトであることに注意してください。ClientBehavior の実装は、ClientBehaviorContexts への参照を保持してはなりません。NullPointerExceptionSE
- behaviorContext
が null
の場合 void decode(FacesContext context, UIComponent component)
指定された FacesContext
に含まれるリクエストから、この ClientBehavior
の新しい状態をデコードします。
デコード中に、queueEvent()
を呼び出すことにより、後の処理のために(インタレストを登録したイベントリスナーによって)イベントがキューに入れられる場合があります。デフォルトの実装は、デコードを ClientBehaviorRenderer.decode(FacesContext, UIComponent, ClientBehavior)
に委譲します
context
- FacesContext
(処理中のリクエスト)component
- UIComponent
この Behavior
に関連付けられているコンポーネント NullPointerExceptionSE
- context
または component
が null
の場合。SetSE<ClientBehaviorHint> getHints()
ClientBehavior 実装の動作を説明するヒントを返します。ヒントは、振る舞いが存在する場合のレンダラーの動作に影響を与える可能性があります。例: ClientBehaviorHint.SUBMITTING
を指定する動作が存在する場合、レンダラーはそれ自体が生成するスクリプトを代替することを選択できます。
Copyright © 2019 Eclipse Foundation.
Use is subject to license terms.