Template: Bagian I

Template dipakai untuk menetapkan penyajian tata letak kontrol. Sebuah template dapat berisi teks statis, komponen, atau kontrol yang membantu penyajian kontrol terkait. Standarnya, turunan TTemplateControl atau subkelasnya secara otomatis mengambil dan menurunkan template dari sebuah file yang namanya sama dengan nama kelas kontrol. Untuk template halaman, nama file harus berakhiran .page; untuk kontrol template reguler lainnya, akhirannya adalah .tpl.

Format template mirrip HTML, dengan beberapa tag spesifik-PRADO, termasuk tag komponen, tag kontrol template, tag komentar, tag konten dinamis, and tag properti dinamis. .

Tag Komponen

Tag komponen menetapkan komponen sebagai bagian dari konten body pada kontrol template. Jika komponen adalah sebuah kontrol, biasanya akan menjadi anak atau cucu dari kontrol template, dan hasil penyajiannya akan disisipkan di tempat di mana ia terlihat dalam template.

Format dari tag komponen adalah sebagai berikut, <com:ComponentType PropertyName="PropertyValue" ... EventName="EventHandler" ...> body content </com:ComponentType> ComponentType berupa nama kelas atau nama tipe bertitik (contoh System.Web.UI.TControl) pada komponen. PropertyName dan EventName keduanya tidak sensitif-huruf. PropertyName bisa berupa nama properti atau subproperti (contoh Font.Name). Catatan, PropertyValue menjadi dekode HTML saat ditempatkan ke properti terkait. Konten dikurung diantara tag komponen pembuka dan penutup biasanya diperlakukan sebagai badan komponen.

Diperlukan bahwa tag properti komponen saling mengumpulkan dan tag komponen pembuka dipasangkan dengan tag penutup, mirip dengan apa yang ada dalam XML.

Template berikut memperlihatkan sebuah tag komponen yang menetapkan properti Text dan event OnClick dari kontrol tombol, <com:TButton Text="Register" OnClick="registerUser" /> Catatan, nama properti dan nama event semuanya tidak sensitif-huruf, sementara nama tipe komponen adalah sensitif-huruf. Nama event selalu diawali dengan On.

Juga diperhatikan, nilai awal untuk properti yang namanya diakhiri dengan Template diproses secara khusus. Dalam keadaan tertentu, nilai awal diurai sebagai obyek TTemplate. Properti ItemTemplate dari kontrol TRepeater dalam contoh tersebut.

Untuk menjembatani properti dengan tempat data besar, tag inisialisasi properti berikut diperkenalkan. Ini sama dengan ...PropertyName="PropertyValue"... pada setiap aspeknya. Tag inisialisasi properti harus secara langsung dikurung diantara tag pembuka dan penutup komponen.

<prop:PropertyName> PropertyValue </prop:PropertyName>

Sejak versi 3.1.0, inisialisasi tag properti dapat juga dipakai untuk menginisialisasi set subproperti yang berbagi properti leluhur yang sama. Sebagai contoh, yang berikut adalah sama HeaderStyle.BackColor="black" dan HeaderStyle.ForeColor="red".

<prop:HeaderStyle BackColor="black" ForeColor="red" />

ID Komponen

Ketika ditetapkan dalam template, properti ID komponen mempunyai arti khusus sebagai tambahan terhadap definisi properti normalnya. Tag komponen yang ditetapkan dengan nilai ID dalam template akan meregistrasi komponen terkait ke dalam kontrol pemilik template. Selanjutnya komponen dapat diakses secara langsung dari kontrol template dengan nilai ID-nya. Sebagai contoh, dalam template halaman Home, tag komponen berikut <com:TTextBox ID="TextBox" Text="First Name" /> memungkinkan untuk memperoleh obyek kotak teks dalam kode menggunakan $page->TextBox.

Tag Kontrol Template

Tag kontrol template digunakan untuk mengkonfigurasi nilai properti awal dari kontrol yang memiliki template. Formatnya adalah sebagai berikut, <%@ PropertyName="PropertyValue" ... %> Seperti dalam tag komponen, PropertyName adalah tidak sensitif-huruf dan bisa berupa nama properti atau subproperti.

Nilai awal yang ditetapkan melalui tag kontrol template ditempatkan ke properti terkait saat kontrol template dibentuk. Oleh karena itu, Anda dapat mengganti nilai properti ini dalam langkah berikutnya, seperti tahap Init dari kontrol.

Tag kontrol template adalah opsional dalam sebuah template. Setiap template dapat berisi paling banyak satu tag kontrol template. Anda dapat menempatkan tag kontrol template di mana saja di dalam template. Direkomendasikan bahwa Anda menempatkannya di awal template untuk visibilitas lebih baik.

Tag Komentar

Tag komentar dipakai untuk menyimpan komentar pengembang dalam template yang tidak akan ditampilkan ke pengguna-akhir. Isi dikurung di dalam tag komentar akan diperlakukan sebagai teks tring biasa dan PRADO tidak akan mencoba untuk menguraikannya. Tag komentar tidak bisa dipakai di dalam nilai properti. Format tag komentar adalah sebagai berikut,

<!--- Komentar TIDAK TERLIHAT bagi pengguna-akhir --->
Catatan: Tag komentar baru <!--- ... ---> diperkenalkan sejak PRADO versi 3.1. Sebelumnya adalah <!-- ... --!> yang tidak dipakai lagi karena beberapa editor mempunyai masalah dalam penerangan-sintaks tag seperti itu.

Tag Include

Sejak versi 3.0.5, PRADO mulai mendukung penyertaan template eksternal. Ini dilakukan melalui tag include, di mana file template eksternal ditetapkan dalam format namespace dan nama filenya harus diakhiri dengan .tpl.

<%include path.to.templateFile %>

Template eksternal akan disisipkan di tempat di mana tag include terjadi dalam basis template.

Catatan, pengulangan penyertaan template tidak didukung, misalnya Anda tidak dapat mempunyai tag include di dalam template eksternal.