Kontrol Aktif (kontrol AJAX-dihidupkan) - Framework Prado

Lihat Pengenalan untuk tinjauan cepat terhadap konsep di belakang kontrol aktif (kontrol AJAX-dihidupkan). Banyak kontrol aktif memiliki properti ActiveControl dan sub-properti ClientSide yang menyediakan banyak properti untuk mengkustomisasi kontrol. Properti CallbackClient dari kelas TPage menyediakan metode untuk memutakhirkan dan mengubah konten sisi-klien saat permintaan callback. Kontrol aktif bergantung pada koleksi kelas javascript.

Untuk demo cepat atas kontrol aktif, coba kontrol TActiveButton. Lihat juga bagian akhir dari tutorial Pengubah Kurs untuk contoh lebih mendalam.

* tutorial untuk kontrol ini belum lengkap.

Kontrol Aktif Standar

• TActiveButton mewakili tombol klik pada halaman Web. Ia dapat dipakai untuk memicu permintaan callback.
• TActiveCheckBox mewakili kotak centang pada halaman Web. Ia dapat dipakai untuk mengoleksi input dua-kondisi pengguna serta memicu permintaan callback.
• TActiveCustomValidator memvalidasi kontrol tertentu menggunakan permintaan callback.
• TActiveHyperLink mewakili hiperlink pada halaman Web.
• TActiveImage mewakili gambar pada halaman Web.
• TActiveImageButton mewakili tombol klik yang mempunyai gambar sebagai latar belakangnya. Ia bisa dipakai untuk memicu permintaan callback.
• TActiveLabel mewakili label pada halam Web. Label dapat dikustomisasi melalui berbagai atribut CSS.
• TActiveLinkButton mewakili hiperlink yang bisa melalukan permintaan callback.
• TActivePanel mewakili penampung untuk kontrol lain pada halaman Web. Dalam HTML, ia ditampilkan sebagai elemen <div>. Kontrol pabel dapat diganti selama permintaan callback.
• TActiveRadioButton mewakili tombol radio pada halaman Web. Dipakai terutama dalam sebuah grup di mana pengguna bisa memilih. Ini dapat digunakan untuk melakukan permintaan callback.
• TActiveTextBox mewakili field input teks pada halaman Web. Ia bisa mengoleksi satu-baris, multi-baris atau input teks sandi dari pengguna. Ia bisa dipakai untuk melakukan permintaan callback.
• TCallbackOptions opsi callback seperti pengendali event sisi-klien OnLoading.

Kontrol List Aktif

• TActiveCheckBoxList menampilkan daftar kotak centang pada halaman Web dan setiap kotak centang dapat memicu permintaan callback.
• TActiveDropDownList menampilkan kotak daftar dropdown yang membolehkan para pengguna untuk memilih satu opsi dari beberapa yang telah ditetapkan. Dapat dipakai untuk melakukan permintaan callback.
• TActiveListBox menampilkan kotak daftar yang membolehkan satu pilihan atau multipel. Dapat dipakai untuk melakukan permintaan callback.
• TActiveRadioButtonList mirip dengan TActiveCheckBoxList dalam setiap aspek kecuali bahwa setiap TActiveRadioButtonList menampilkan sebuah grup tombol radio. Setiap tombol radio dapat melakukan permintaan callback.

Kontrol Aktif Diperluas

• TAutoComplete memperluas TActiveTextBox untuk menawarkan saran pelengkapan teks.
• TCallback kontrol generik yang dapat melakukan permintaan callback.
• TEventTriggeredCallback memicu permintaan callback berdasarkan event DOM HTML.
• TInPlaceTextBox mewakili label yang dapat diedit dengen mengklik.
• * TTimeTriggeredCallback memicu permintaan callback berdasarkan waktu yang belalu.
• * TValueTriggeredCallback mengawasi (menggunakan timer) atribut elemen HTML dan memicu permintaan callback ketika nilai atribut berubah.

Kemampuan Kontrol Aktif

Tabel berikut memperlihatkan Kontrol Aktif yang dapat memicu event callback dan menentukan apakah kontrol akan memunculkan event PostBack atau tidak jika Javascript dimatikan pada browser sisi-klien.

Nama Kontrol	Memicu Callback	Kembali ke PostBack
TActiveButton	Ya	Ya
TActiveCheckBox	Ya	Ya
TActiveCustomValidator	Ya	Ya
TActiveHyperLink	Tidak	Ya
TActiveImage	Tidak	Ya
TActiveImageButton	Ya	Ya
TActiveLabel	Tidak	Ya
TActiveLinkButton	Ya	Tidak
TActivePanel	Tidak	Ya
TActiveRadioButton	Ya	Ya
TActiveTextBox	Ya	Ya
TCallbackOptions	Tidak	N/A
TActiveCheckBoxList	Ya	Ya
TActiveDropDownList	Ya	Ya
TActiveListBox	Ya	Ya
TActiveRadioButtonList	Ya	Ya
TAutoComplete	Ya	Tidak
TCallback	Ya	Tidak
TEventTriggeredCallback	Ya	Tidak
TInPlaceTextBox	Ya	Tidak
TTimeTriggeredCallback	Ya	Tidak
TValueTriggeredCallback	Ya	Tidak

Kelas Infrastruktur Kontrol Aktif

Kelas berikut menyediakan kelas infrastruktur dasar yang diperlukan guna merealisasikan kontrol aktif.

• TActiveControlAdapter melacak nilai viewstate dari kontrol dan memutakhirkan perbedaan pada atribut elemen HTML sisi-klien.
• TActiveListControlAdapter membolehkan kontrol list yang diadaptasi untuk mengubah pilihan pada sisi-klien selama permintaan callback.
• TActivePageAdapter memroses masa-hidup halaman untuk permintaan callback.
• TBaseActiveControl metode dan opsi kontrol aktif umum.
• TCallbackClientScript metode untuk memanipulasi elemen HTML sisi-klien, juga termasuk metode untuk memanggil Efek javascript pada elemen HTML.
• TCallbackClientSide opsi permintaan callback sisi-klien, dan pengendali event sisi-klien.
• TCallbackResponseAdapter respon HTTP untuk permintaan callback.