jQuery UI widget metode panggilan

Widget (Widget) oleh anggota perpustakaan (widget Factory) menggunakan metode untuk mengubah status mereka dan melakukan tindakan setelah inisialisasi dibuat. Ada dua cara untuk memanggil metode widget - melalui perpustakaan anggota (Widget Factory) untuk membuat plug-in, atau dengan metode contoh elemen dari sebuah objek pada panggilan.

Plug-in panggilan

Widget metode plug-panggilan, nama metode sebagai string berlalu. Misalnya, klik di sini untuk melihat, bagaimana memanggil (dialog) widget dialog close() metode .

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

Jika metode ini memerlukan parameter, diteruskan ke plug-in sebagai parameter tambahan. Klik di sini untuk melihat, bagaimana memanggil dialog (dialog) dari option() metode .

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

Ini mengembalikan dialog (dialog) di height pilihan nilai-nilai.

contoh Panggilan

Setiap contoh dari setiap widget menggunakan jQuery.data() disimpan dalam elemen. Untuk mengambil sebuah contoh dari sebuah objek, menggunakan nama lengkap widget untuk memanggil sebagai kunci jQuery.data() . Sebagai contoh spesifik yang ditunjukkan di bawah.

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

Setelah Anda referensi sebuah instance dari sebuah objek, Anda dapat memanggil metode langsung di atas.

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

Dalam jQuery UI 1.11, yang baru instance() metode akan membuat proses ini lebih mudah.

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

Kembali Jenis

Sebagian besar metode yang disebut oleh plugin widget akan kembali jQuery objek, sehingga metode dapat dipanggil melalui tambahan metode link di jQuery. Ketika disebut pada contoh, ia mengembalikan undefined . Sebagai contoh spesifik yang ditunjukkan di bawah.

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" );

Sangat, metode tersebut kembali informasi tentang widget. Misalnya dialog (dialog) dari isOpen() metode .

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

Hal ini menghasilkan TypeError kesalahan karena isOpen() mengembalikan nilai Boolean, bukan objek jQuery.