jQueryのUIウィジェットのメソッド呼び出し

ウィジェット(ウィジェット) 会員図書館(ウィジェットファクトリー)自分のステータスを変更し、初期化が作成された後のアクションを実行するための方法を使用して。 プラグインを作成するには会員図書館(ウィジェットファクトリー)を介して、またはコール上のオブジェクトの要素インスタンスの方法によって - 2つのウィジェットメソッドを呼び出す方法があります。

プラグインの呼び出し

ウィジェットプラグインの呼び出し方法、渡された文字列としてメソッド名。 たとえば、呼び出す方法、こちらをクリックしてダイアログ(対話)ウィジェットclose()メソッド

$( ".selector" ).dialog( "close" );

この方法は、パラメータを必要とする場合、追加のパラメータとしてプラグインに渡されました。 呼び出す方法を参照するには、ここをクリックしてのダイアログ(対話) option()メソッドを

$( ".selector" ).dialog( "option", "height" );

これは、返すにダイアログ(対話) heightオプション値を。

例コール

各ウィジェットの各インスタンスに使用されるjQuery.data()要素に格納されています。 オブジェクトのインスタンスを取得するためには、キーとして呼び出すためにウィジェットの完全な名前を使用しjQuery.data() 具体例としては、以下に示します。

var dialog = $( ".selector" ).data( "ui-dialog" );

あなたがオブジェクトのインスタンスを参照したら、直接上記のメソッドを呼び出すことができます。

var dialog = $( ".selector" ).data( "ui-dialog" );
dialog.close();

jQueryのUI 1.11では、新たなinstance()メソッドは、このプロセスが容易になります。

$( ".selector" ).dialog( "instance" ).close();

戻り型

ウィジェットプラグインによって呼び出されたメソッドのほとんどが返されますjQueryメソッドが追加jQueryのメソッドリンクを介して呼び出すことができるので、オブジェクトを。 インスタンス上で呼び出された場合、それを返しundefined 。 具体例としては、以下に示します。

var dialog = $( ".selector" ).dialog();
 
// Instance invocation - returns undefined
dialog.data( "ui-dialog" ).close();
 
// Plugin invocation - returns a jQuery object
dialog.dialog( "close" );
 
// Therefore, plugin method invocation makes it possible to
// chain method calls with other jQuery functions
dialog.dialog( "close" )
    .css( "color", "red" );

例外的に、これらのメソッドは、ウィジェットに関する情報を返します。 例のためのダイアログ(対話) isOpen()メソッド

$( ".selector" )
    .dialog( "isOpen" )
    // This will throw a TypeError
    .css( "color", "red" );

これは、その結果TypeErrorため、エラーisOpen()ブール値ではなく、jQueryオブジェクトを返します。