Files
smarty/docs/ru/designers/language-builtin-functions/language-function-capture.xml
2006-06-01 12:50:31 +00:00

97 lines
2.8 KiB
XML

<?xml version="1.0" encoding="windows-1251"?>
<!-- $Revision$ -->
<!-- EN-Revision: 1.13 Maintainer: freespace Status: ready -->
<sect1 id="language.function.capture">
<title>capture</title>
<para>
{capture} èñïîëüçóåòñÿ äëÿ òîãî, ÷òîáû ñîáðàòü ðåçóëüòàò îáðàáîòêè
÷àñòè øàáëîíà ìåæäó òýãàìè
â êàêóþ-òî ïåðåìåííóþ, âìåñòî òîãî, ÷òîáû âûâåñòè ðåçóëüòàò áðàóçåðó.
Ëþáîå ñîäåðæèìîå ìåæäó {capture name='foo'} è {/capture} ñîõðàíÿåòñÿ â
ïåðåìåííóþ, óêàçàííóþ â àòðèáóòå name.
</para>
<para>
Çàõâà÷åííûå äàííûå ìîãóò â äàëüíåéøåì èñïîëüçîâàòüñÿ â
øàáëîíå ïðè ïîìîùè ñïåöèàëüíîé ïåðåìåííîé <link
linkend="language.variables.smarty.capture">$smarty.capture.foo</link>,
ãäå "foo" - çíà÷åíèå, ïåðåäàííîå àòðèáóòó name. Åñëè àòðèáóò name íå óêàçàí,
òî èñïîëüçóåòñÿ "default".
</para>
<para>
Êîìàíäà capture ïîääåðæèâàåò âëîæåííîñòü.
</para>
<caution>
<para>
Áóäòå îñòîðîæíû, ñîõðàíÿÿ âûâîä êîìàíäû <link
linkend="language.function.insert">{insert}</link>.
Åñëè âû èñïîëüçóåòå <link linkend="caching">êýøèðîâàíèå</link>
è â îáëàñòè êýøèðîâàíèÿ âñòðå÷àþòñÿ êîìàíäû
<command>insert</command>, òî íå ñîõðàíÿéòå äàííûé âûâîä.
</para>
</caution>
<para>
<example>
<title>Ñîõðàíåíèå âûâîäà øàáëîíà</title>
<programlisting>
<![CDATA[
{* ìû íå õîòèì âûâîäèòü ñëîé div, åñëè ñîäåðæèìîå íå îòîáðàæàåòñÿ *}
{capture name=banner}
{include file='get_banner.tpl'}
{/capture}
{if $smarty.capture.banner ne ''}
<div id="banner">{$smarty.capture.banner}</div>
{/if}
]]>
</programlisting>
</example>
<example>
<title>ñîõðàíåíèå ñîäåðæèìîãî â ïåðåìåííóþ</title>
<para>
Ýòîò ïðèìåð òàêæå äåìîíñòðèðóåò ôóíêöèþ
<link linkend="language.function.popup">{popup}</link>
</para>
<programlisting>
<![CDATA[
{capture name=some_content assign=popText}
The server is {$smarty.server.SERVER_NAME|upper} at {$smarty.server.SERVER_ADDR}<br />
Your ip is {$smarty.server.REMOTE_ADDR}.
{/capture}
<a href="#" {popup caption='Server Info' text=$popText}>help</a>
]]>
</programlisting>
</example>
</para>
<para>
Ñì. òàêæå
<link linkend="language.variables.smarty.capture">$smarty.capture</link>,
<link linkend="language.function.eval">{eval}</link>,
<link linkend="language.function.fetch">{fetch}</link>,
<link linkend="api.fetch">fetch()</link>
è <link linkend="language.function.assign">{assign}</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
-->