Sys.Application.findComponent メソッド
更新 : 2007 年 11 月
指定した Component オブジェクトを返します。これは静的メンバで、クラスのインスタンスを作成しなくても呼び出すことができます。
var o = Sys.Application.findComponent(id, parent)
引数
id
検索対象コンポーネントの ID が格納された文字列。parent
(省略可能) 検索対象コンポーネントが格納されているコンポーネントまたは要素。
戻り値
見つかった場合は、要求された ID を持つコンポーネントを格納している Component オブジェクト。それ以外の場合は null。
解説
findComponent メソッドを使用すると、addComponent メソッドを使用してアプリケーションによって登録された Component オブジェクトへの参照を取得します。parent が指定されていない場合、検索対象は最上位コンポーネントに限定されます。parent が Component オブジェクトを表している場合、検索対象は指定したコンポーネントの子に限定されます。parent が DOM 要素の場合、検索対象は指定した要素の子コンポーネントに限定されます。
findComponent メソッドは、$find ショートカット メソッドを使用して呼び出すこともできます。
使用例
次の例では、findComponent メソッドを使用して、カスタム コンポーネントが存在することを確認し、見つからなかった場合はユーザーに通知します。
function checkComponent() {
if (!($find('MyComponent', div1))) {
div1.innerHTML = 'MyComponent is not available.';
}
}