yii/docs/guide/id/basics.view.txt

Tampilan
========

Tampilan (view) adalah skrip PHP yang berisi terutama elemen antar muka pengguna. View
bisa saja berisi pernyataan PHP, tetapi direkomendasikan bahwa pernyataan ini
tidak mengubah model data dan harus tetap relatif sederhana. Dalam rangka mempertahankan semangat
pemisahan logika dan penampilan, bagian besar logika harus ditempatkan
dalam kontroler atau model alih-alih view.

View  memiliki nama yang dipakai untuk mengidentifikasi file skrip tampilan
saat me-render. Nama view sama seperti nama file skrip view-nya.
Sebagai contoh, tampilan `edit` merujuk pada file skrip bernama seperti
`edit.php`. Untuk me-render tampilan, pangil [CController::render()] dengan
nama tampilan. Metode tersebut akan mencari file view terkait di bawah direktori
`protected/views/ControllerID`.

Di dalam skrip view, kita dapat mengakses instance kontroler menggunakan
`$this`. Selanjutnya kita bisa `menarik` setiap properti kontroler dengan
mengevaluasi `$this->propertyName` dalam tampilan.

Kita juga bisa menggunakan pendekatan `dorong` berikut guna mengoper data ke tampilan:

~~~
[php]
$this->render('edit', array(
	'var1'=>$value1,
	'var2'=>$value2,
));
~~~

Dalam contoh di atas, metode [render()|CController::render] akan mengurai parameter array 
kedua ke dalam variabel. Hasilnya, dalam skrip tampilan kita dapat mengakses
variabel lokal `$var1` dan `$var2`.

Tata Letak
----------

Tata letak(layout) adalah view khusus yang dipakai untuk mendekorasi tampilan. Biasanya
berisi bagian antar muka pengguna yang umum diantara beberapa view.
Sebagai contoh, sebuah layout mungkin berisi bagian header dan footer serta menyertakan
tampilan konten diantarana,

~~~
[php]
......header di sini......
<?php echo $content; ?>
......footer di sini......
~~~

dengan `$content` menyimpan hasil render view konten.

Layout secara implisit diterapkan saat memanggil [render()|CController::render].
Secara default, skrip view `protected/views/layouts/main.php` dipakai sebagai
layout. Ini bisa dikustomisasi dengan mengubah baik [CWebApplication::layout]
ataupun [CController::layout]. Sebaliknya, untuk menyiapkan tampilan tanpa menerapkan layout apapun,
panggil [renderPartial()|CController::renderPartial].

Widget
------

Widget adalah istance dari [CWidget] atau anak kelasnya. Komponen yang
terutama ditujukan guna keperluan penampilan. Widget biasanya disertakan dalam skrip
view untuk menghasilkan beberapa antar muka pengguna yang kompleks dan berdiri sendiri. Sebagai
contoh, widget kalender bisa dipakai untuk menyiapkan antar muka kalender pengguna yang 
kompleks. Widget menghidupkan pemakaian kembali yang lebih baik dalam antar muka pengguna.

Untuk menggunakan widget, lakukan seperti berikut dalam skrip tampilan:

~~~
[php]
<?php $this->beginWidget('path.to.WidgetClass'); ?>
...konten body yang dapat ditangkap oleh widget...
<?php $this->endWidget(); ?>
~~~

atau

~~~
[php]
<?php $this->widget('path.to.WidgetClass'); ?>
~~~

Contoh kedua dipakai saat widget tidak memerlukan konten body apapun.

Widget dapat dikonfigurasi untuk mengkustomisasi perilakunya. Ini dilakukan dengan
menyetel nilai properti awalnya ketika memanggil
[CBaseController::beginWidget] atau [CBaseController::widget]. Sebagai contoh,
ketika menggunakan widget [CMaskedTextField], kita ingin menetapkan pelapisan
agar dipakai. Kita dapat melakukannya dengan mengoper array nilai awal properti
itu sebagai berikut, di mana kunci array adalah nama properti dan nilai array
adalah nilai awal pada properti widget terkait:

~~~
[php]
<?php
$this->widget('CMaskedTextField',array(
	'mask'=>'99/99/9999'
));
?>
~~~

Untuk mendefinisikan widget baru, turunkan [CWidget] dan override metode
[init()|CWidget::init] dan [run()|CWidget::run]:

~~~
[php]
class MyWidget extends CWidget
{
	public function init()
	{
		// metode ini dipanggil oleh CController::beginWidget()
	}

	public function run()
	{
		// metode ini dipanggil oleh CController::endWidget()
	}
}
~~~

Sama seperti halnya dengan kontroler, widget juga bisa memiliki tampilan sendiri. Standarnya, file
tampilan widget ditempatkan di bawah subdirektori `views` pada direktori
yang berisi file kelas widget. View ini dapat di-render dengan memanggil
[CWidget::render()], mirip dengan pemanggilan kontroler. Perbedaannya adalah
tidak ada tata letak(layout) yang akan diterapkan pada tampilan widget. Selain itu,
`$this` dalam view juga merujuk ke instance widget alih-alih instance controller.


View Sistem
---------------

View(tampilan) sistem merujuk pada tampilan yang dipakai oleh Yii untuk menampilkan kesalahan dan pencatatan(logging)
informasi. Sebagai contoh, ketika permintaan pengguna untuk kontroler atau aksi 
yang tidak ada, Yii akan memunculkan exception yang menjelaskan kesalahan. Yii menampilkan
exception menggunakan tampilan sistem tertentu.

Penamaan view sistem mengikuti beberapa aturan. Nama seperti `errorXXX` merujuk pada
tampilan untuk menampilkan [CHttpException] dengan kode kesalahan `XXX`. Sebagai contoh, jika [CHttpException] dimunculkan dengan kode kesalahan 404, view `error404`
akan ditampilkan.

Yii menyediakan satu set tampilan sistem default yang ditempatkan di bawah
`framework/views`. View-view ini bisa dikustomisasi dengan membuat file tampilan yang sama dengan nama yang sama di bawah `protected/views/system`.

<div class="revision">$Id: basics.view.txt 2367 2010-08-29 17:29:22Z qiang.xue $</div>