Files
smarty/docs/id/designers/language-custom-functions/language-function-assign.xml
2007-09-18 17:45:46 +00:00

158 lines
4.3 KiB
XML

<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision$ -->
<sect1 id="language.function.assign">
<title>{assign}</title>
<para>
<varname>{assign}</varname> dipakai untuk menempatkan variabel template
<emphasis role="bold">selama eksekusi sebuah template</emphasis>.
</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>Nama Atribut</entry>
<entry>Tipe</entry>
<entry>Diperlukan</entry>
<entry>Default</entry>
<entry>Deskripsi</entry>
</row>
</thead>
<tbody>
<row>
<entry>var</entry>
<entry>string</entry>
<entry>Ya</entry>
<entry><emphasis>n/a</emphasis></entry>
<entry>Nama variabel yang ditempati</entry>
</row>
<row>
<entry>value</entry>
<entry>string</entry>
<entry>Ya</entry>
<entry><emphasis>n/a</emphasis></entry>
<entry>Nilai yang ditempatkan</entry>
</row>
</tbody>
</tgroup>
</informaltable>
<example>
<title>{assign}</title>
<programlisting>
<![CDATA[
{assign var='name' value='Bob'}
Nilai dari $name adalah {$name}.
]]>
</programlisting>
<para>
Contoh di atas akan menampilkan:
</para>
<screen>
<![CDATA[
Nilai dari $name adalah Bob.
]]>
</screen>
</example>
<example>
<title>{assign} with some maths</title>
<para>Contoh kompleks harus memiliki variabel dalam `tanda kutip terbalik`</para>
<programlisting>
<![CDATA[
{assign var=running_total value=`$running_total+$some_array[row].some_value`}
]]>
</programlisting>
</example>
<example>
<title>Mengakses variabel {assign} dari naskah PHP</title>
<para>
Untuk mengakses variabel <varname>{assign}</varname> dari naskah php
menggunakan <link linkend="api.get.template.vars">
<varname>get_template_vars()</varname></link>.
Ini adalah template yang membuat variabel <parameter>$foo</parameter>.
</para>
<programlisting>
<![CDATA[
{assign var='foo' value='Smarty'}
]]>
</programlisting>
<para>Variabel template hanya tersedia setelah/selama eksekusi template seperti
dalam naskah berikut.
</para>
<programlisting role="php">
<![CDATA[
<?php
// ini tidak akan menampilkan apapun karena template belum dieksekusi
echo $smarty->get_template_vars('foo');
// ambil template ke variabel
$whole_page = $smarty->fetch('index.tpl');
// ini akan menampilkan 'smarty' karena template sudah dieksekusi
echo $smarty->get_template_vars('foo');
$smarty->assign('foo','Even smarter');
// ini akan menampilkan 'Even smarter'
echo $smarty->get_template_vars('foo');
?>
]]>
</programlisting>
</example>
<para>
Fungsi berikut dapat juga <emphasis>secara opsional</emphasis> menempatkan
variabel template.
</para>
<para>
<link linkend="language.function.capture"><varname>{capture}</varname></link>,
<link linkend="language.function.include"><varname>{include}</varname></link>,
<link linkend="language.function.include.php"><varname>{include_php}</varname></link>,
<link linkend="language.function.insert"><varname>{insert}</varname></link>,
<link linkend="language.function.counter"><varname>{counter}</varname></link>,
<link linkend="language.function.cycle"><varname>{cycle}</varname></link>,
<link linkend="language.function.eval"><varname>{eval}</varname></link>,
<link linkend="language.function.fetch"><varname>{fetch}</varname></link>,
<link linkend="language.function.math"><varname>{math}</varname></link>,
<link linkend="language.function.textformat"><varname>{textformat}</varname></link>
</para>
<para>
Lihat juga <link linkend="api.assign"><varname>assign()</varname></link>
dan
<link linkend="api.get.template.vars"><varname>get_template_vars()</varname></link>.
</para>
</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
-->