Smarty Icon

You may use the Smarty logo according to the trademark notice.

Smarty Template Engine Smarty Template Engine

For sponsorship, advertising, news or other inquiries, contact us at:

Sites Using Smarty

Advertisement

Manual Smarty
KembaliBab 7. Built-in FunctionsLanjut

{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 AtributTipeDiperlukanDefaultDeskripsi
namestringYan/aNama seksi
loopmixedYan/aNilai untuk menentukan sumber iterasi pengulangan
startintegerTidak0Posisi 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.
stepintegerTidak1Nilai 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.
maxintegerTidakn/aMenyetel angka maksimum berapa kali seksi akan mengulang.
showbooleanTidakTRUEMenentukan 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.

KembaliDepanLanjut
{php}Induk{strip}
credits copyright

Smarty Copyright © 2002 – 2025 New Digital Group, Inc. All rights reserved.

This page generated in 0.00656 secs with TinyMVC and Smarty 3.