mirror of
https://github.com/smarty-php/smarty.git
synced 2025-10-04 08:10:55 +02:00
460 lines
13 KiB
XML
460 lines
13 KiB
XML
<?xml version="1.0" encoding="iso-8859-1"?>
|
|
<!-- $Revision$ -->
|
|
<sect1 id="language.function.foreach">
|
|
<title>{foreach},{foreachelse}</title>
|
|
<para>
|
|
<varname>{foreach}</varname> dipakai untuk mengulang terus-menerus melalui
|
|
<emphasis role="bold">array asosiatif</emphasis> juga array-diindeks secara
|
|
numerik, tidak seperti <link linkend="language.function.section"><varname>{section}</varname></link>
|
|
yang untuk mengulang melalui <emphasis role="bold">hanya array-diindeks secara numerik</emphasis>.
|
|
Sintaks untuk
|
|
<varname>{foreach}</varname> jauh lebih mudah daripada
|
|
<link linkend="language.function.section"><varname>{section}</varname></link>,
|
|
tapi sebagai imbalannya <emphasis role="bold">hanya bisa dipakai untuk array
|
|
tunggal</emphasis>. Setiap tag <varname>{foreach}</varname> harus
|
|
dipasangkan dengan tag <varname>{/foreach}</varname> penutup.
|
|
</para>
|
|
|
|
<informaltable frame="all">
|
|
<tgroup cols="5">
|
|
<colspec colname="param" align="center" />
|
|
<colspec colname="type" align="center" />
|
|
<colspec colname="required" align="center" />
|
|
<colspec colname="default" align="center" />
|
|
<colspec colname="desc" />
|
|
<thead>
|
|
<row>
|
|
<entry>Attribute Name</entry>
|
|
<entry>Type</entry>
|
|
<entry>Required</entry>
|
|
<entry>Default</entry>
|
|
<entry>Description</entry>
|
|
</row>
|
|
</thead>
|
|
<tbody>
|
|
<row>
|
|
<entry>from</entry>
|
|
<entry>array</entry>
|
|
<entry>Yes</entry>
|
|
<entry><emphasis>n/a</emphasis></entry>
|
|
<entry>Array yang anda ulang terus</entry>
|
|
</row>
|
|
<row>
|
|
<entry>item</entry>
|
|
<entry>string</entry>
|
|
<entry>Yes</entry>
|
|
<entry><emphasis>n/a</emphasis></entry>
|
|
<entry>Nama variabel yang jadi elemen saat ini</entry>
|
|
</row>
|
|
<row>
|
|
<entry>key</entry>
|
|
<entry>string</entry>
|
|
<entry>No</entry>
|
|
<entry><emphasis>n/a</emphasis></entry>
|
|
<entry>Nama variabel yang saat ini jadi kunci</entry>
|
|
</row>
|
|
<row>
|
|
<entry>name</entry>
|
|
<entry>string</entry>
|
|
<entry>No</entry>
|
|
<entry><emphasis>n/a</emphasis></entry>
|
|
<entry>Nama perulangan foreach untuk mengakses properti</entry>
|
|
</row>
|
|
</tbody>
|
|
</tgroup>
|
|
</informaltable>
|
|
|
|
|
|
<itemizedlist>
|
|
<listitem><para>
|
|
Atribut yang diperlukan adalah <parameter>from</parameter> dan <parameter>item</parameter>.
|
|
</para></listitem>
|
|
|
|
<listitem><para>
|
|
<parameter>Name</parameter> dari pengulangan <varname>{foreach}</varname>
|
|
bisa apa saja yang anda sukai, terdiri dari huruf, angka dan garis bawah,
|
|
seperti
|
|
<ulink url="&url.php-manual;language.variables">variabel PHP</ulink>.
|
|
</para></listitem>
|
|
|
|
<listitem><para>
|
|
Pengulangan <varname>{foreach}</varname> bisa diulang terus, dan nama
|
|
<varname>{foreach}</varname> yang diulang harus unik dari yang lain.
|
|
</para></listitem>
|
|
|
|
<listitem><para>
|
|
Atribut <parameter>from</parameter>, biasanya sebuah array nilai,
|
|
menetapkan jumlah berapa kali <varname>{foreach}</varname> akan diulang.
|
|
</para></listitem>
|
|
|
|
<listitem><para>
|
|
<varname>{foreachelse}</varname> dijalankan ketika tidak ada nilai dalam
|
|
variabel <parameter>from</parameter>.
|
|
</para></listitem>
|
|
|
|
<listitem><para>
|
|
Pengulangan <varname>{foreach}</varname> juga memiliki variabelnya
|
|
sendiri yang menangani properti. Ini diakses dengan:
|
|
<link linkend="language.variables.smarty.loops">
|
|
<parameter>{$smarty.foreach.name.property}</parameter></link> dengan
|
|
<quote>name</quote> menjadi atribut
|
|
<parameter>name</parameter>.
|
|
</para>
|
|
<note>
|
|
<title>Catatan</title>
|
|
<para>Atribut <parameter>name</parameter> hanya diperlukan saat anda ingin
|
|
mengakses properti <varname>{foreach</varname>}, tidak seperti
|
|
<link linkend="language.function.section"><varname>{section}</varname></link>.
|
|
Mengakses properti <varname>{foreach}</varname> dengan <parameter>name</parameter>
|
|
tidak terdefinisi tidak menimbulkan kesalahan, tapi sebaliknya
|
|
mengakibatkan hasil yang tidak diinginkan.
|
|
</para>
|
|
</note>
|
|
</listitem>
|
|
|
|
<listitem><para>
|
|
Properti <varname>{foreach}</varname> adalah
|
|
<link linkend="foreach.property.index"><parameter>index</parameter></link>,
|
|
<link linkend="foreach.property.iteration"><parameter>iteration</parameter></link>,
|
|
<link linkend="foreach.property.first"><parameter>first</parameter></link>,
|
|
<link linkend="foreach.property.last"><parameter>last</parameter></link>,
|
|
<link linkend="foreach.property.show"><parameter>show</parameter></link>,
|
|
<link linkend="foreach.property.total"><parameter>total</parameter></link>.
|
|
</para></listitem>
|
|
|
|
</itemizedlist>
|
|
|
|
<example>
|
|
<title>Atribut <parameter>item</parameter></title>
|
|
<programlisting role="php">
|
|
<![CDATA[
|
|
<?php
|
|
$arr = array(1000, 1001, 1002);
|
|
$smarty->assign('myArray', $arr);
|
|
?>
|
|
]]>
|
|
</programlisting>
|
|
<para>Template untuk ditampilkan <parameter>$myArray</parameter> dalam daftar tidak-berurut</para>
|
|
<programlisting>
|
|
<![CDATA[
|
|
<ul>
|
|
{foreach from=$myArray item=foo}
|
|
<li>{$foo}</li>
|
|
{/foreach}
|
|
</ul>
|
|
]]>
|
|
</programlisting>
|
|
<para>
|
|
Contoh di atas akan menampilkan:
|
|
</para>
|
|
<screen>
|
|
<![CDATA[
|
|
<ul>
|
|
<li>1000</li>
|
|
<li>1001</li>
|
|
<li>1002</li>
|
|
</ul>
|
|
]]>
|
|
</screen>
|
|
</example>
|
|
|
|
<example>
|
|
<title>Mendemonstrasikan atribut <parameter>item</parameter> dan <parameter>key</parameter></title>
|
|
<programlisting role="php">
|
|
<![CDATA[
|
|
<?php
|
|
$arr = array(9 => 'Tennis', 3 => 'Swimming', 8 => 'Coding');
|
|
$smarty->assign('myArray', $arr);
|
|
?>
|
|
]]>
|
|
</programlisting>
|
|
<para>Template untuk ditampilkan <parameter>$myArray</parameter> sebagai
|
|
pasangan kunci/nilai, seperti
|
|
<ulink url="&url.php-manual;foreach"><varname>foreach</varname></ulink>
|
|
PHP.</para>
|
|
<programlisting>
|
|
<![CDATA[
|
|
<ul>
|
|
{foreach from=$myArray key=k item=v}
|
|
<li>{$k}: {$v}</li>
|
|
{/foreach}
|
|
</ul>
|
|
]]>
|
|
</programlisting>
|
|
<para>
|
|
Contoh di atas akan menampilkan:
|
|
</para>
|
|
<screen>
|
|
<![CDATA[
|
|
<ul>
|
|
<li>9: Tennis</li>
|
|
<li>3: Swimming</li>
|
|
<li>8: Coding</li>
|
|
</ul>
|
|
]]>
|
|
</screen>
|
|
</example>
|
|
|
|
|
|
<example>
|
|
<title>{foreach} dengan asosiatif atribut <parameter>item</parameter></title>
|
|
<programlisting role="php">
|
|
<![CDATA[
|
|
<?php
|
|
$items_list = array(23 => array('no' => 2456, 'label' => 'Salad'),
|
|
96 => array('no' => 4889, 'label' => 'Cream')
|
|
);
|
|
$smarty->assign('items', $items_list);
|
|
?>
|
|
]]>
|
|
</programlisting>
|
|
<para>Template untuk ditampilkan <parameter>$items</parameter> dengan
|
|
<parameter>$myId</parameter> dalam url</para>
|
|
<programlisting>
|
|
<![CDATA[
|
|
<ul>
|
|
{foreach from=$items key=myId item=i}
|
|
<li><a href="item.php?id={$myId}">{$i.no}: {$i.label}</li>
|
|
{/foreach}
|
|
</ul>
|
|
]]>
|
|
</programlisting>
|
|
<para>
|
|
Contoh di atas akan menampilkan:
|
|
</para>
|
|
<screen>
|
|
<![CDATA[
|
|
<ul>
|
|
<li><a href="item.php?id=23">2456: Salad</li>
|
|
<li><a href="item.php?id=96">4889: Cream</li>
|
|
</ul>
|
|
]]>
|
|
</screen>
|
|
</example>
|
|
|
|
<example>
|
|
<title>{foreach} dengan pengulangan <parameter>item</parameter> dan <parameter>key</parameter></title>
|
|
<para>Menempatkan array ke Smarty, kunci berisi kunci untuk setiap nilai
|
|
yang diulang.</para>
|
|
<programlisting role="php">
|
|
<![CDATA[
|
|
<?php
|
|
$smarty->assign('contacts', array(
|
|
array('phone' => '1',
|
|
'fax' => '2',
|
|
'cell' => '3'),
|
|
array('phone' => '555-4444',
|
|
'fax' => '555-3333',
|
|
'cell' => '760-1234')
|
|
));
|
|
?>
|
|
]]>
|
|
</programlisting>
|
|
<para>Template yang menampilkan <parameter>$contact</parameter>.</para>
|
|
<programlisting>
|
|
<![CDATA[
|
|
{foreach name=outer item=contact from=$contacts}
|
|
<hr />
|
|
{foreach key=key item=item from=$contact}
|
|
{$key}: {$item}<br />
|
|
{/foreach}
|
|
{/foreach}
|
|
]]>
|
|
</programlisting>
|
|
<para>
|
|
Contoh diatas akan menampilkan:
|
|
</para>
|
|
<screen>
|
|
<![CDATA[
|
|
<hr />
|
|
phone: 1<br />
|
|
fax: 2<br />
|
|
cell: 3<br />
|
|
<hr />
|
|
phone: 555-4444<br />
|
|
fax: 555-3333<br />
|
|
cell: 760-1234<br />
|
|
]]>
|
|
</screen>
|
|
</example>
|
|
|
|
<example>
|
|
<title>Contoh database dengan {foreachelse}</title>
|
|
<para>Contoh database (seperti PEAR atau ADODB) dari naskah pencarian, hasil query
|
|
ditempatkan ke Smarty</para>
|
|
<programlisting role="php">
|
|
<![CDATA[
|
|
<?php
|
|
$search_condition = "where name like '$foo%' ";
|
|
$sql = 'select contact_id, name, nick from contacts '.$search_condition.' order by name';
|
|
$smarty->assign('results', $db->getAssoc($sql) );
|
|
?>
|
|
]]>
|
|
</programlisting>
|
|
<para>Template yang menampilkan <quote>None found</quote>
|
|
jika tidak ada hasil dengan <varname>{foreachelse}</varname>.</para>
|
|
<programlisting>
|
|
<![CDATA[
|
|
{foreach key=cid item=con from=$results}
|
|
<a href="contact.php?contact_id={$cid}">{$con.name} - {$con.nick}</a><br />
|
|
{foreachelse}
|
|
No items were found in the search
|
|
{/foreach}
|
|
]]>
|
|
</programlisting>
|
|
</example>
|
|
|
|
|
|
<sect2 id="foreach.property.index">
|
|
<title>.index</title>
|
|
<para>
|
|
<parameter>index</parameter> berisi indeks array saat ini, dimulai dengan nol.
|
|
</para>
|
|
<example>
|
|
<title>contoh <parameter>index</parameter></title>
|
|
|
|
<programlisting role="php">
|
|
<![CDATA[
|
|
{* Blok header ditampilkan setiap lima baris *}
|
|
<table>
|
|
{foreach from=$items key=myId item=i name=foo}
|
|
{if $smarty.foreach.foo.index % 5 == 0}
|
|
<tr><th>Title</th></tr>
|
|
{/if}
|
|
<tr><td>{$i.label}</td></tr>
|
|
{/foreach}
|
|
</table>
|
|
]]>
|
|
</programlisting>
|
|
</example>
|
|
</sect2>
|
|
|
|
<sect2 id="foreach.property.iteration">
|
|
<title>.iteration</title>
|
|
<para>
|
|
<parameter>iteration</parameter> berisi iterasi perulangan saat ini dan
|
|
selalu dimulai dari satu, tidak seperti
|
|
<link linkend="foreach.property.index"><parameter>indeks</parameter></link>.
|
|
Ia bertambah satu setiap kali iterasi.
|
|
</para>
|
|
<example>
|
|
<title>contoh <parameter>iteration</parameter> dan <parameter>indeks</parameter></title>
|
|
<programlisting role="php">
|
|
<![CDATA[
|
|
{* ini akan menampilkan 0|1, 1|2, 2|3, ... dst *}
|
|
{foreach from=$myArray item=i name=foo}
|
|
{$smarty.foreach.foo.index}|{$smarty.foreach.foo.iteration},
|
|
{/foreach}
|
|
]]>
|
|
</programlisting>
|
|
</example>
|
|
|
|
</sect2>
|
|
|
|
<sect2 id="foreach.property.first">
|
|
<title>.first</title>
|
|
<para>
|
|
<parameter>first</parameter> adalah &true; jika iterasi <varname>{foreach}</varname>
|
|
saat ini adalah yang awal.
|
|
</para>
|
|
<example>
|
|
<title>contoh properti <parameter>first</parameter></title>
|
|
<programlisting role="php">
|
|
<![CDATA[
|
|
{* tampilkan LATEST pada item pertama, sebaliknya id *}
|
|
<table>
|
|
{foreach from=$items key=myId item=i name=foo}
|
|
<tr>
|
|
<td>{if $smarty.foreach.foo.first}LATEST{else}{$myId}{/if}</td>
|
|
<td>{$i.label}</td>
|
|
</tr>
|
|
{/foreach}
|
|
</table>
|
|
]]>
|
|
</programlisting>
|
|
</example>
|
|
</sect2>
|
|
|
|
<sect2 id="foreach.property.last">
|
|
<title>.last</title>
|
|
<para>
|
|
<parameter>last</parameter> disetel &true; jika iterasi
|
|
<varname>{foreach}</varname> saat ini adalah yang terakhir.
|
|
</para>
|
|
<example>
|
|
<title>contoh properti <parameter>last</parameter></title>
|
|
<programlisting role="php">
|
|
<![CDATA[
|
|
{* Tambah garis horisontal di akhir daftar *}
|
|
{foreach from=$items key=part_id item=prod name=products}
|
|
<a href="#{$part_id}">{$prod}</a>{if $smarty.foreach.products.last}<hr>{else},{/if}
|
|
{foreachelse}
|
|
... konten ...
|
|
{/foreach}
|
|
]]>
|
|
</programlisting>
|
|
</example>
|
|
</sect2>
|
|
|
|
<sect2 id="foreach.property.show">
|
|
<title>.show</title>
|
|
<para>
|
|
<parameter>show</parameter> dipakai sebagai parameter untuk <varname>{foreach}</varname>.
|
|
<parameter>show</parameter> adalah nilai boolean. Jika &false;,
|
|
<varname>{foreach}</varname> tidak akan ditampilkan. Jika terdapat
|
|
<varname>{foreachelse}</varname>, akan ditampilkan secara selang-seling.
|
|
</para>
|
|
|
|
</sect2>
|
|
<sect2 id="foreach.property.total">
|
|
<title>.total</title>
|
|
<para>
|
|
<parameter>total</parameter> berisi jumlah iterasi yang akan diulang
|
|
<varname>{foreach}</varname>.
|
|
Ini dapat digunakan di dalam atau setelah <varname>{foreach}</varname>.
|
|
</para>
|
|
<example>
|
|
<title>contoh properti <parameter>total</parameter></title>
|
|
<programlisting role="php">
|
|
<![CDATA[
|
|
{* menampilkan baris yang dikembalikan di akhir *}
|
|
{foreach from=$items key=part_id item=prod name=foo}
|
|
{$prod.name><hr/>
|
|
{if $smarty.foreach.foo.last}
|
|
<div id="total">{$smarty.foreach.foo.total} items</div>
|
|
{/if}
|
|
{foreachelse}
|
|
... something else ...
|
|
{/foreach}
|
|
]]>
|
|
</programlisting>
|
|
</example>
|
|
|
|
<para>
|
|
Lihat juga <link linkend="language.function.section"><varname>{section}</varname></link>
|
|
dan <link linkend="language.variables.smarty.loops"><parameter>$smarty.foreach</parameter></link>.
|
|
</para>
|
|
</sect2>
|
|
</sect1>
|
|
|
|
<!-- Keep this comment at the end of the file
|
|
Local variables:
|
|
mode: sgml
|
|
sgml-omittag:t
|
|
sgml-shorttag:t
|
|
sgml-minimize-attributes:nil
|
|
sgml-always-quote-attributes:t
|
|
sgml-indent-step:1
|
|
sgml-indent-data:t
|
|
indent-tabs-mode:nil
|
|
sgml-parent-document:nil
|
|
sgml-default-dtd-file:"../../../../manual.ced"
|
|
sgml-exposed-tags:nil
|
|
sgml-local-catalogs:nil
|
|
sgml-local-ecat-files:nil
|
|
End:
|
|
vim600: syn=xml fen fdm=syntax fdl=2 si
|
|
vim: et tw=78 syn=sgml
|
|
vi: ts=1 sw=1
|
|
-->
|