Files
smarty/docs/ru/designers/language-custom-functions/language-function-cycle.xml
2004-04-15 15:47:00 +00:00

135 lines
4.7 KiB
XML

<?xml version="1.0" encoding="windows-1251"?>
<!-- $Revision$ -->
<sect1 id="language.function.cycle">
<title>cycle</title>
<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>Èìÿ àòòðèáóòà</entry>
<entry>Òèï</entry>
<entry>Îáÿçàòåëåí</entry>
<entry>Ïî óìîë÷àíèþ</entry>
<entry>Îïèñàíèå</entry>
</row>
</thead>
<tbody>
<row>
<entry>name</entry>
<entry>ñòðîêà (string)</entry>
<entry>Íåò</entry>
<entry><emphasis>default</emphasis></entry>
<entry>Íàçâàíèå öèêëà</entry>
</row>
<row>
<entry>values</entry>
<entry>mixed</entry>
<entry>Äà</entry>
<entry><emphasis>N/A</emphasis></entry>
<entry>Çíà÷åíèÿ, ïî êîòîðûì áóäåò ïðîèçâîäèòüñÿ öèêë.
Ëèáî ñïèñîê, ðàçäåëåíûé çàïÿòûìè (ëèáî äðóãèì óêàçàííûì
ðàçäåëèòåëåì), ëèáî ìàññèâ çíà÷åíèé.</entry>
</row>
<row>
<entry>print</entry>
<entry>ëîãè÷åñêèé (boolean)</entry>
<entry>Íåò</entry>
<entry><emphasis>true</emphasis></entry>
<entry>Âûâîäèòü çíà÷åíèå, èëè íåò</entry>
</row>
<row>
<entry>advance</entry>
<entry>ëîãè÷åñêèé (boolean)</entry>
<entry>Íåò</entry>
<entry><emphasis>true</emphasis></entry>
<entry>Ïåðåêëþ÷àòüñÿ èëè íåò íà ñëåäóþùåå çíà÷åíèå</entry>
</row>
<row>
<entry>delimiter</entry>
<entry>ñòðîêà (string)</entry>
<entry>Íåò</entry>
<entry><emphasis>,</emphasis></entry>
<entry>Ðàçäåëèòåëü, èñïîëüçóåìûé â àòòðèáóòå values.</entry>
</row>
<row>
<entry>assign</entry>
<entry>ñòðîêà (string)</entry>
<entry>Íåò</entry>
<entry><emphasis>n/a</emphasis></entry>
<entry>Èìÿ ïåðåìåííîé, êîòîðîé áóäåò ïðèñâîåí âûâîä òýãà</entry>
</row>
</tbody>
</tgroup>
</informaltable>
<para>
Cycle èñïîëüçóåòñÿ äëÿ ïðîõîäà ÷åðåç ìíîæåñòâî çíà÷åíèé.
Ñ åãî ïîìîùüþ ìîæíî ëåãêî ðåàëèçîâàòü ïåðåêëþ÷åíèå ìåæäó
äâóìÿ è áîëåå öâåòàìè â òàáëèöå, èëè ïðîéòè öèêë ÷åðåç
ìàññèâ.
</para>
<para>
Ìîæíî ïðîõîäèòü ÷åðåç íåñêîëüêî ìíîæåñòâ çíà÷åíèé îäíîâðåìåííî,
óêàçàâ àòòðèáóò name. Èìåíà äîëæíû áûòü óíèêàëüíûìè.
</para>
<para>
Ìîæíî íå îòîáðàæàòü äàííûé ýëåìåíò, óñòàíîâèâ àòòðèáóò print â
ëîæü (false). Óäîáíî äëÿ ïðîïóñêà çíà÷åíèÿ, áåç åãî âûâîäà.
</para>
<para>
Àòòðèáóò advance èñïîëüçóåòñÿ äëÿ ïîâòîðà çíà÷åíèÿ. Åñëè
óñòàíîâëåí â èñòèíà (true), òî ïðè ñëåäóþùåì âûçîâå cycle
áóäåò âûâåäåíî òî æå çíà÷åíèå.
</para>
<para>
Åñëè óêàçàí ñïåöèàëüíûé àòòðèáóò "assign", òî âûâîä cycle
ïðèñâàèâàåòñÿ ïåðåìåííîé, âìåñòî îòîáðàæåíèÿ.
</para>
<example>
<title>cycle</title>
<programlisting>
{section name=rows loop=$data}
&lt;tr bgcolor="{cycle values="#eeeeee,#d0d0d0"}"&gt;
&lt;td&gt;{$data[rows]}&lt;/td&gt;
&lt;/tr&gt;
{/section}
OUTPUT:
&lt;tr bgcolor="#eeeeee"&gt;
&lt;td&gt;1&lt;/td&gt;
&lt;/tr&gt;
&lt;tr bgcolor="#d0d0d0"&gt;
&lt;td&gt;2&lt;/td&gt;
&lt;/tr&gt;
&lt;tr bgcolor="#eeeeee"&gt;
&lt;td&gt;3&lt;/td&gt;
&lt;/tr&gt;
</programlisting>
</example>
</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
-->