Manual Smarty
Kembali	Bab 7. Built-in Functions	Lanjut

{section},{sectionelse}

{section} adalah untuk mengulang melalui array data, tidak seperti {foreach} yang dipakai untuk mengulang melalui satu array asosiatif. Setiap {section} tag harus dipasangkan dengan penutup{/section} tag.

Nama Atribut	Tipe	Diperlukan	Default	Deskripsi
name	string	Ya	n/a	Nama seksi
loop	mixed	Ya	n/a	Nilai untuk menentukan sumber iterasi pengulangan
start	integer	Tidak	0	Posisi indeks di mana seksi akan diulang. Jika nilai negatif, awal posisi dihitung dari akhir array. Sebagai contoh, jika ada tujuh nilai dalam pengulangan array dan awalnya adalah -2, indeks awal adalah 5. Nilai yang tidak benar (nilai di luar panjang pengulangan array) otomatis dipotong ke nilai terdekat yang benar.
step	integer	Tidak	1	Nilai step akan dipakai untuk melewati pengulangan array. Sebagai contoh, step=2 akan berulang pada indeks 0,2,4, dst. Jika step negatif, ia akan mundur kembali melewati array.
max	integer	Tidak	n/a	Menyetel angka maksimum berapa kali seksi akan mengulang.
show	boolean	Tidak	`TRUE`	Menentukan apakan menampilkan seksi ini atau tidak

Atribut yang diperlukan adalah name dan loop.
name dari {section} bisa berupa apapun yang anda suka, terdiri dari huruf, angka dan garis bawah, seperti variabel PHP.
{section} dapat diulang, dan nama {section} yang diulang harus unik dari yang lainnya.
Atribut loop, biasanya sebuah array nilai, menentukan jumlah berapa kali {section} akan mengulang. Anda juga dapat mengirimkan integer sebagai nilai pengulangan.
Ketika mencetak variabel di dalam {section}, {section} name harus diberikan di sebelah nama variabel dalam [kurung kotak].
{sectionelse} dijalankan saat tidak ada lagi nilai dalam variabel loop.
{section} juga memiliki variabelnya sendiri yang menangani properti {section}. Properti ini dapat diakses sebagai: {$smarty.section.name.property} di mana "name" adalah atribut name.
properti {section} adalah index, index_prev, index_next, iteration, first, last, rownum, loop, show, total.

Teladan 7-30. Mengulang array sederhana dengan {section}

assign() array ke Smarty

assign(\'custid\',$data); ?>'); ?>

Template yang menampilkan array

{* contoh ini akan mengeluarkan semua nilai dari array $custid *}
{section name=customer loop=$custid}
  id: {$custid[customer]}<br />
{/section}
<hr />
{* mengeluarkan semua nilai array $custid secara terbalik *}
{section name=foo loop=$custid step=-1}
  {$custid[foo]}<br />
{/section}

Contoh di atas akan menampilkan:

id: 1000<br />
id: 1001<br />
id: 1002<br />
<hr />
id: 1002<br />
id: 1001<br />
id: 1000<br />

Teladan 7-31. {section} tanpa array yang ditempati

{section name=foo start=10 loop=20 step=2}
  {$smarty.section.foo.index}
{/section}
<hr />
{section name=bar loop=21 max=6 step=-2}
  {$smarty.section.bar.index}
{/section}

Contoh di atas akan menampilkan:

10 12 14 16 18
<hr />
20 18 16 14 12 10

Teladan 7-32. Penamaan {section}

name dari {section} bisa apa saja sesuai yang anda inginkan, lihat variabel PHP. Ini dipakai untuk mereferensi data di dalam {section}.

{section name=anything loop=$myArray}
  {$myArray[anything].foo}
  {$name[anything]}
  {$address[anything].bar}
{/section}

Teladan 7-33. Pengulangan array asosiatif dengan {section}

Ini adalah contoh pencetakan array data asosiatif dengan {section}. Berikut adalah naskah php untuk menempatkan array $contacts ke Smarty.

\'John Smith\', \'home\' => \'555-555-5555\', \'cell\' => \'666-555-5555\', \'email\' => \'john@myexample.com\'), array(\'name\' => \'Jack Jones\', \'home\' => \'777-555-5555\', \'cell\' => \'888-555-5555\', \'email\' => \'jack@myexample.com\'), array(\'name\' => \'Jane Munson\', \'home\' => \'000-555-5555\', \'cell\' => \'123456\', \'email\' => \'jane@myexample.com\') ); $smarty->assign(\'contacts\',$data); ?>'); ?>

Template untuk menampilkan $contacts

{section name=customer loop=$contacts}
<p>
  name: {$contacts[customer].name}<br />
  home: {$contacts[customer].home}<br />
  cell: {$contacts[customer].cell}<br />
  e-mail: {$contacts[customer].email}
</p>
{/section}

Contoh di atas akan menampilkan:

<p>
  name: John Smith<br />
  home: 555-555-5555<br />
  cell: 666-555-5555<br />
  e-mail: john@myexample.com
</p>
<p>
  name: Jack Jones<br />
  home phone: 777-555-5555<br />
  cell phone: 888-555-5555<br />
  e-mail: jack@myexample.com
</p>
<p>
  name: Jane Munson<br />
  home phone: 000-555-5555<br />
  cell phone: 123456<br />
  e-mail: jane@myexample.com
</p>

Teladan 7-34. {section} mendemonstrasikan variabel loop

Contoh ini mengasumsikan bahwa $custid, $name dan $address adalah semua array yang berisi jumlah nilai yang sama. Pertama naskah php menempatkan array ke Smarty.

assign(\'custid\',$id); $fullnames = array(\'John Smith\',\'Jack Jones\',\'Jane Munson\'); $smarty->assign(\'name\',$fullnames); $addr = array(\'253 Abbey road\', \'417 Mulberry ln\', \'5605 apple st\'); $smarty->assign(\'address\',$addr); ?>'); ?>

Variabel loop hanya menentukan jumlah berapa kali untuk mengulang. Anda dapat mengakses variabel MANAPUN dari template di dalam {section}

{section name=customer loop=$custid}
<p>
  id: {$custid[customer]}<br />
  name: {$name[customer]}<br />
  address: {$address[customer]}
</p>
{/section}

Contoh di atas akan menampilkan:

<p>
  id: 1000<br />
  name: John Smith<br />
  address: 253 Abbey road
</p>
<p>
  id: 1001<br />
  name: Jack Jones<br />
  address: 417 Mulberry ln
</p>
<p>
  id: 1002<br />
  name: Jane Munson<br />
  address: 5605 apple st
</p>

Teladan 7-35. {section} yang berulang

{section} dapat diulang sedalam yang anda suka. Dengan {section} yang diulang, anda bisa mengakses struktur data yang kompleks, seperti array multi dimensi. Ini adalah contoh naskah .php yang menempatkan array.

assign(\'custid\',$id); $fullnames = array(\'John Smith\',\'Jack Jones\',\'Jane Munson\'); $smarty->assign(\'name\',$fullnames); $addr = array(\'253 N 45th\', \'417 Mulberry ln\', \'5605 apple st\'); $smarty->assign(\'address\',$addr); $types = array( array( \'home phone\', \'cell phone\', \'e-mail\'), array( \'home phone\', \'web\'), array( \'cell phone\') ); $smarty->assign(\'contact_type\', $types); $info = array( array(\'555-555-5555\', \'666-555-5555\', \'john@myexample.com\'), array( \'123-456-4\', \'www.example.com\'), array( \'0457878\') ); $smarty->assign(\'contact_info\', $info); ?>'); ?>

Dalam contoh ini, $contact_type[customer] adalah sebuah array tipe kontak untuk kustomer saat ini.

{section name=customer loop=$custid}
<hr>
  id: {$custid[customer]}<br />
  name: {$name[customer]}<br />
  address: {$address[customer]}<br />
  {section name=contact loop=$contact_type[customer]}
    {$contact_type[customer][contact]}: {$contact_info[customer][contact]}<br />
  {/section}
{/section}

Contoh di atas akan menampilkan:

<hr>
  id: 1000<br />
  name: John Smith<br />
  address: 253 N 45th<br />
    home phone: 555-555-5555<br />
    cell phone: 666-555-5555<br />
    e-mail: john@myexample.com<br />
<hr>
  id: 1001<br />
  name: Jack Jones<br />
  address: 417 Mulberry ln<br />
    home phone: 123-456-4<br />
    web: www.example.com<br />
<hr>
  id: 1002<br />
  name: Jane Munson<br />
  address: 5605 apple st<br />
    cell phone: 0457878<br />

Teladan 7-36. Contoh database dengan {sectionelse}

Hasil pencarian database (misal ADODB atau PEAR) ditempatkan ke Smarty

assign(\'contacts\', $db->getAll($sql)); ?>'); ?>

Template yang menampilkan hasil database dalam tabel HTML

<table>
<tr><th>&nbsp;</th><th>Name></th><th>Home</th><th>Cell</th><th>Email</th></tr>
{section name=co loop=$contacts}
  <tr>
    <td><a href="view.php?id={$contacts[co].id}">view<a></td>
    <td>{$contacts[co].name}</td>
    <td>{$contacts[co].home}</td>
    <td>{$contacts[co].cell}</td>
    <td>{$contacts[co].email}</td>
  <tr>
{sectionelse}
  <tr><td colspan="5">Tidak ada item yang ditemukan</td></tr>
{/section}
</table>

.index

index berisi indeks array saat ini, dimulai dengan nol atau atribut start bila diberikan. Ia bertambah satu atau dengan atribut step bila diberikan.

Catatan Teknis: Jika properti step dan start tidak diubah, maka pekerjaan ini sama seperti properti iteration, kecuali ia dimulai dengan nol daripada satu.

Teladan 7-37. {section} index property

FYI: $custid[customer.index] dan $custid[customer] adalah sama.

{section name=customer loop=$custid}
  {$smarty.section.customer.index} id: {$custid[customer]}<br />
{/section}

Contoh di atas akan menampilkan:

0 id: 1000<br />
1 id: 1001<br />
2 id: 1002<br />

.index_prev

index_prev adalah indeks pengulangan sebelumnya. Pada pengulangan pertama, ini disetel -1.

.index_next

index_next adalah indeks pengulangan berikutnya. Pada pengulangan terakhir, ini masih satu lagi daripada indeks saat ini, memperhatikan setelan atribut step, jika diberikan.

Teladan 7-38. properti index, index_next dan index_prev

assign(\'rows\',$data); ?>'); ?>

Template untuk menampilkan array di atas dalam sebuah tabel

{* $rows[row.index] dan $rows[row] adalah identik dalam pengertian *}
<table>
  <tr>
    <th>index</th><th>id</th>
    <th>index_prev</th><th>prev_id</th>
    <th>index_next</th><th>next_id</th>
  </tr>
{section name=row loop=$rows}
  <tr>
    <td>{$smarty.section.row.index}</td><td>{$rows[row]}</td>
    <td>{$smarty.section.row.index_prev}</td><td>{$rows[row.index_prev]}</td>
    <td>{$smarty.section.row.index_next}</td><td>{$rows[row.index_next]}</td>
  </tr>
{/section}
</table>

Contoh di atas akan menampilkan tabel yang berisi sebagai berikut:

index  id    index_prev prev_id index_next next_id
0      1001  -1	                1          1002
1      1002  0          1001    2          1003
2      1003  1          1002    3          1004
3      1004  2          1003    4          1005
4      1005  3          1004    5

.iteration

iteration berisi iterasi pengulangan saat ini dan dimulai dari satu.

Catatan: Ini tidak dipengaruhi oleh properti {section} start, step dan max, tidak seperti properti index. iteration juga dimulai dengan satu daripada nol tidak seperti index. rownum adalah alias untuk iteration, keduanya sama.

Teladan 7-39. Properti iteration dari seksi

assign(\'arr\',$id); ?>'); ?>

Template untuk menampilkan setiap elemen lain array $arr dengan step=2

{section name=cu loop=$arr start=5 step=2}
  iteration={$smarty.section.cu.iteration}
  index={$smarty.section.cu.index}
  id={$custid[cu]}<br />
{/section}

Contoh di atas akan menampilkan:

iteration=1 index=5 id=3005<br />
iteration=2 index=7 id=3007<br />
iteration=3 index=9 id=3009<br />
iteration=4 index=11 id=3011<br />
iteration=5 index=13 id=3013<br />
iteration=6 index=15 id=3015<br />

Contoh lain yang menggunakan properti iteration untuk mengeluarkan blok header tabel setiap lima baris. Menggunakan fungsi {if} dengan operator mod.

<table>
{section name=co loop=$contacts}
  {if $smarty.section.co.iteration % 5 == 1}
    <tr><th>&nbsp;</th><th>Name></th><th>Home</th><th>Cell</th><th>Email</th></tr>
  {/if}
  <tr>
    <td><a href="view.php?id={$contacts[co].id}">view<a></td>
    <td>{$contacts[co].name}</td>
    <td>{$contacts[co].home}</td>
    <td>{$contacts[co].cell}</td>
    <td>{$contacts[co].email}</td>
  <tr>
{/section}
</table>

.first

first disetel TRUE jika iterasi {section} saat ini adalah yang pertama.

.last

last disetel TRUE jika iterasi seksi saat ini adalah yang terakhir.

Teladan 7-40. properti {section} first dan last

Contoh ini mengulang array $customers, mengeluarkan blok header pada iterasi pertama dan terakhir mengeluarkan blok footer. Juga menggunakan properti total.

{section name=customer loop=$customers}
  {if $smarty.section.customer.first}
    <table>
    <tr><th>id</th><th>kustomer</th></tr>
  {/if}

  <tr>
    <td>{$customers[customer].id}}</td>
    <td>{$customers[customer].name}</td>
  </tr>

  {if $smarty.section.customer.last}
    <tr><td></td><td>{$smarty.section.customer.total} kustomer</td></tr>
    </table>
  {/if}
{/section}

.rownum

rownum berisi iterasi pengulangan saat ini, dimulai dengan satu. Ini adalah nama lain dari iterasi, cara kerjanya sama persis.

.loop

loop berisi angka indeks terakhir yang mengulang {section}. Ini bisa dipakai di dalam atau setelah {section}.

Teladan 7-41. properti {section} loop

{section name=customer loop=$custid}
  {$smarty.section.customer.index} id: {$custid[customer]}<br />
{/section}
Ada {$smarty.section.customer.loop} kustomer yang ditampilkan di atas.

Contoh di atas akan menampilkan:

0 id: 1000<br />
1 id: 1001<br />
2 id: 1002<br />
Ada 3 kustomer yang ditampilkan di atas.

.show

show dipakai sebagai parameter ke seksi dan berupa nilai boolean. Jika FALSE, seksi tidak akan ditampilkan. Jika terdapat {sectionelse}, akan ditampilkan sebagai alternatif.

Teladan 7-42. show properti

Boolean $show_customer_info sudah dikirimkan dari aplikasi PHP, untuk mengatur apakah seksi ditampilkan atau tidak.

{section name=customer loop=$customers show=$show_customer_info}
  {$smarty.section.customer.rownum} id: {$customers[customer]}<br />
{/section}

{if $smarty.section.customer.show}
  seksi ditampilkan.
{else}
  seksi tidak ditampilkan.
{/if}

Contoh di atas akan menampilkan:

1 id: 1000<br />
2 id: 1001<br />
3 id: 1002<br />

the section was shown.

.total

total berisi jumlah iterasi yang akan {section} mengulangnya. Ini bisa dipakai di dalam atau setelah {section}.

Teladan 7-43. total contoh properti

{section name=customer loop=$custid step=2}
  {$smarty.section.customer.index} id: {$custid[customer]}<br />
{/section}
   Ada {$smarty.section.customer.total} kustomer yang ditampilkan di atas.

Lihat juga {foreach} dan $smarty.section.

Kembali	Depan	Lanjut
{php}	Induk	{strip}

Comments

No comments for this page.

Get Smarty

About Smarty

Resources

Links

Donate

Smarty Icon

Sites Using Smarty

Advertisement

{section},{sectionelse}

.index

.index_prev

.index_next

.iteration

.first

.last

.rownum

.loop

.show

.total

Advertisement

Sponsors [info]

Sponsors