Smarty, šablonovací systém - 6 (vestavěné funkce - 3)

25. 10. 2007 | Tomáš Kavalek

Články - Smarty, šablonovací systém - 6 (vestavěné funkce - 3)  

V dnešním článku navážeme na předchozí díly, ve kterých jsme začali probírat vestavěné funkce Smarty. Tímto dílem zároveň rozbor vestavěných funkcí ukončíme. Najdete tu: literal, php, section, sectionelse, index, index_prev, index_next, iteration, first, last, rownum, loop, show, total a strip.

Obsah

• Úvod
• literal
• php
• section, sectionelse
• index
• index_prev
• index_next
• iteration
• first
• last
• rownum
• loop
• show
• total
• strip
• Závěr

Úvod

Tímto dílem ukončíme seznamování s vestavěnými funkcemi a v díle následujícím se již přejdeme na speciální funkce, tzv. custom functions.

literal

V minulém díle tohoto seriálu jsme se seznámili s funkcemi, resp. tagy, {ldelim} a {rdelim}. Jejich použití je nám tedy známe. Ve větších blocích kódu, kde je potřeba použít závorky { a }, by využití těchto tagů nebylo příliš efektivním. Řešení problému je párový tag {literal}{/literal}. Vše, co je mezi těmito dvěma tagy, není interpretováno šablonovacím strojem, ale je zobrazeno "tak, jak je". Využití nalezneme např. při psaní interních definici CSS stylů nebo u JavaScriptu. Jako vždy nejvíce pomohou k pochopení ukázkové příklady.

Ukázka funkce v JavaScriptu (obdoba funkce s předcházející kapitoly, vysvětlující {ldelim} a {rdelim}):

{literal}
<script type="text/javascript">
function showServerInfo(name, ip) {
alert("Server name:\n" + name + "\n" + ip);
}
</script>
{/literal}
<a href="javascript:showServerInfo('{$smarty.server.SERVER_NAME}', '{$smarty.server.SERVER_ADDR}')">Server Info</a>

Použití při definování interního CSS stylu:

<style type="text/css">
{literal}
/* Definice stylu */
DIV.info {
border: 1px solid #ffffff;
background-color: #aabbcc;
}
{/literal}
</style>
...
<div class="info">Pouziti interniho CSS stylu</div>

php

Tag php slouží pro přímé vložení PHP kódu do šablony. Jedná se o pokročilou techniku, téměř ve všech případech se to dá vyřešit jinak (např. na úrovni pluginů - viz některá z příštích kapitol), vkládání PHP kódu přímo do šablony se nedoporučuje. Důležitým upozorněním je, že pokud chceme ze šablony uvnitř tohoto tagu přistupovat k proměnným PHP, musíme použít globální kontext. Následující příklady demonstrují jednoduché použití tohoto tagu a složitější použití při předávání obsahu proměnné.

{php}
// Vlozeni skriptu zobrazujiciho kurzovni listek (priklad)
include("/cesta/k/souboru/kurzovni-listek.php");
{/php}

Složitější příklad předávání obsahu proměnných z vloženého PHP v šabloně do proměnné v šabloně (zní to složitě, funguje jednoduše):

{php}
global $promenna_1, $promenna_2;
if($promenna_1 == $promenna_2) {
// Nasledujici obsah bude odeslan prohlizeci - jako v beznem PHP
echo("Obe promenne maji stejnou hodnotu - promenna_1 = promenna_2");
}
// Ukazka prirazeni hodnoty do promenne Smarty sablony
$this->assign("tpl_machine", "Smarty Template Engine");
{/php}
{* Vypis definovane promenne na urovni sablony                              *}
<div>Na sablony pouzivame <strong>{$tpl_machine}</strong></div>

section, sectionelse

Jak jsme si již řekli ve čtvtém dílu tohoto seriálu, funkce section slouží k procházení složitějších datových polí. Funkce je, stejně jako foreach, cyklus, takže musí být ukončen - párový tag. Jinak řečeno, vše, co je mezi {section} a {/section}, se "cyklí". Chování lze ovlivnit šesti možnými parametry, z čehož dva jsou povinné. Prvním povinným parametrem je name, pomocí něhož jednoznačně identifikujeme cyklus. Druhým povinným parametrem je loop, který definuje počet iterací. Zadat můžeme číslo nebo objekt, se kterým bude operace provedena. V podstatě tím, že předáme parametru loop pole, dojde k tomu, že Smarty aplikuje na pole PHP funkci sizeof, a dále pracuje s velikostí předaného pole. Uvnitř cyklu pak přistupujeme k libovolné proměnné šablony (nejčastěji k polím).

Následující parametry jsou volitelné. První ze skupiny těchto parametrů je start. Určuje počátek iterace, implicitně je nastaven na číslo 0. Zadáme-li zápornou hodnotu, Smarty provede odpočet od konce pole, a tuto pozici označí jako výchozí. Př.: pole o sedmi hodnotách: zadáme-li -3, počáteční pozice bude na indexu 4. Parametr loop je vnitřně ošetřen tak, že pokud zadáme neplatnou hodnotu, dojde k převedení na nejbližší možnou hodnotu. Dalším parametrem je step, pomocí něhož lze upravovat kroky iterace cyklu. Zadáme-li krok 2, výsledkem bude např. 0 2 4 .... Stejně jako u parametru start lze použít zápornou hodnotu, čímž docílíme zpětného průchodu, tedy např. 10 8 6 ... (při hodnotě -2). Implicitně má step hodnotu 1. Předposledním parametrem je max, který určuje maximální počet iterací cyklu. Implicitní hodnota není stanovena, resp. jedná se o nekonečno. Poslední parametr show může nabývat hodnot TRUE nebo FALSE a slouží k nastavení, zda-li se má výsledek cyklu section zobrazovat. Praktické využití nejlépe pochopíme z příkladů.

Pro následující výpisy předpokládejme přiřazení hodnot do pole v PHP takto:

<?php
$pole = array(10, 20, 30);
$smarty->assign("pole", $pole);
?>

Pro demonstraci použijeme následující šablonu:

{* Cyklus vypise obsah celeho pole $pole                         *}
{section name="vypis_pole" loop=$pole}
{$pole[vypis_pole]}<br />
{/section}
<br />
{* Cyklus vypise obsah celeho pole $pole v opacnem poradi        *}
{section name="vypis_pole_r" loop=$pole step="-1"}
{$pole[vypis_pole_r]}<br />
{/section}

Výstup bude vypadat takto:

10<br />
20<br />
30<br />
<br />
30<br />
20<br />
10<br />

Ne vždy ale potřebujeme procházet pole. V některých případech nám stačí pouze generování čísel dle určitých podmínek. Parametr loop nemusí odkazovat na pole, ale může obsahovat číslo. Hodnotu, na kterou se bude vázat iterace. Stejně jako u foreach můžeme i u této funkce použít konstrukce $smarty.foreach.jmeno.vlastnost. Viz příklad:

{section name="c1" start="0" loop="20" step="4"}
{$smarty.section.c1.index}
{/section}
<br />
{section name="c2" loop="50" max="8" step="-4"}
{$smarty.section.c2.index}
{/section}

Výstupem našeho příkladu bude:

0 4 8 12 16
<br />
49 45 41 37 33 29 25 21

Způsob použití může být i složitější. Pro demonstraci použijeme dvourozměrné pole a zároveň si vysvětlíme použití sectionelse. Část sectionelse se provede pouze tehdy, pokud předáme parametru loop neexistující nebo prázdné pole. V podstatě se jedná o stejný příklad jako u foreach, s tím rozdílem, že tato funkce má nepatrně jiné parametry, tedy i jejich použití.

Pro následující výpisy předpokládejme přiřazení hodnot do pole v PHP takto:

<?php
$smarty->assign("kontakty", array(
		array("jmeno" => "Petr",
			"mail"  => "petr@abclinuxu.cz",
			"mobil" => "775 123 456"),
		array("jmeno" => "Martin",
			"mail"  => "martin@abclinuxu.cz",
			"mobil" => "776 123 456"),
		array("jmeno" => "Jan",
			"mail"  => "jan@abclinuxu.cz",
			"mobil" => "777 123 456")));
?>

K demonstraci výpisu použijeme následující šablonu:

<table>
<tr>
<td><b>Jméno</b></td>
<td><b>E-mail</b></td>
<td><b>Telefon</b></td>
</tr>
{section name="zamestnanci" loop=$kontakty}
<tr>
<td>{$kontakty[zamestnanci].jmeno}</td>
<td>{$kontakty[zamestnanci].mail}</td>
<td>{$kontakty[zamestnanci].mobil}</td>
</tr>
{sectionelse}
{* Tato cast se provede v pripade prazdneho pole *}
<tr>
<td><b>Neplatná vstupní data</b></td>
</tr>
{/section}
</table>

Výstupem této šablony bude (v případě existujícího vstupu, jinak se provede větev sectionelse) toto:

<table>
<tr>
<td><b>Jméno</b></td>
<td><b>E-mail</b></td>
<td><b>Telefon</b></td>
</tr>
<tr>
<td>Petr</td>
<td>petr@abclinuxu.cz</td>
<td>775 123 456</td>
</tr>
<tr>
<td>Martin</td>
<td>martin@abclinuxu.cz</td>
<td>776 123 456</td>
</tr>
<tr>
<td>Jan</td>
<td>jan@abclinuxu.cz</td>
<td>777 123 456</td>
</tr>
</table>

Někdy se může stát, že máme stejné hodnoty jako v předchozím případě, ale v jednorozměrných polích. K úspěšnému projití polí potřebujeme splnit jednu důležitou podmínku, a to stejný rozměr všech polí. Je-li tato podmínka splněna, můžeme projít všechny pole pomocí jednoho iterátoru (resp. na ostatní pole použijeme iterátor pole prvního). Představme si tedy, že místo vícerozměrného pole $kontakty máme tři pole: $jmeno, $mail a $mobil:

<?php
$smarty->assign("jmeno", array("Petr", "Martin", "Jan"));
$smarty->assign("mail", array("petr@abclinuxu.cz", "martin@abclinuxu.cz", "jan@abclinuxu.cz"));
$smarty->assign("mobil", array("775 123 456", "776 123 456", "777 123 456"));
?> 

Šablona na průchod může vypadat takto:

{section name="zamestnanci" loop=$jmeno}
<p>
Jmeno: {$jmeno[zamestnanci]}<br />
Mail: {$mail[zamestnanci]}<br />
Telefon: {$mobil[zamestnanci]}
</p>
{/section}

Výsledek by měl být jasný, ale pro jistotu:

<p>
Jmeno: Petr<br />
Mail: petr@abclinuxu.cz<br />
Telefon: 775 123 456
</p>
<p>
Jmeno: Martin<br />
Mail: martin@abclinuxu.cz<br />
Telefon: 776 123 456
</p>
<p>
Jmeno: Jan<br />
Mail: jan@abclinuxu.cz<br />
Telefon: 777 123 456
</p>

Samozřejmostí je možnost zanořování cyklů do sebe, tedy uvnitř section může být jiný cyklus. Příklad můžeme postavit na předcházejících ukázkách, s tím rozdílem, že každý uživatel bude mít několik telefonních čísel. Pro demonstraci potřebujeme nějaké vícerozměrné pole naplněné hodnotami; použijeme následující:

<?php
$smarty->assign("kontakty", array(
	array("jmeno" => "Petr",
		"mail"  => "petr@abclinuxu.cz",
		"telefony" => array("775 123 456", "234 567 890")),
	array("jmeno" => "Martin",
		"mail"  => "martin@abclinuxu.cz",
		"telefony" => array("776 123 456", "234 567 891")),
	array("jmeno" => "Jan",
		"mail"  => "jan@abclinuxu.cz",
		"telefony" => array("777 123 456", "234 567 892"))));
?>

Jednoduchá šablona, která vypíše obsah pole $code a tím demonstruje zanoření dvou cyklů do sebe, vypadá takto:

<table>
<tr>
<td><b>Jméno</b></td>
<td><b>E-mail</b></td>
<td><b>Telefony</b></td>
</tr>
{section name="zamestnanci" loop=$kontakty}
<tr>
<td>{$kontakty[zamestnanci].jmeno}</td>
<td>{$kontakty[zamestnanci].mail}</td>
<td>
{section name="telefony" loop=$kontakty[zamestnanci].telefony}
{$kontakty[zamestnanci].telefony[telefony]}<br />
{/section}
</td>
</tr>
{sectionelse}
{* Tato cast se provede v pripade prazdneho pole *}
<tr>
<td><b>Neplatná vstupní data</b></td>
</tr>
{/section}
</table> 

Výsledek této šablony bude dle očekávání:

<table>
<tr>
<td><b>Jméno</b></td>
<td><b>E-mail</b></td>
<td><b>Telefony</b></td>
</tr>
<tr>
<td>Petr</td>
<td>petr@abclinuxu.cz</td>
<td>775 123 456<br />234 567 890</td>
</tr>
<tr>
<td>Martin</td>
<td>martin@abclinuxu.cz</td>
<td>776 123 456<br />234 567 891</td>
</tr>
<tr>
<td>Jan</td>
<td>jan@abclinuxu.cz</td>
<td>777 123 456<br />234 567 892</td>
</tr>
</table>

Již víme, že pomocí speciální konstrukce můžeme získávat informace o průběhu cyklu. Konstrukce $smarty.section.jmeno.vlastnost, umožňuje použít následující vlastnosti: index, index_prev, index_next, iteration, first, last, rownum, show a total.

index

Pomocí této vlastnosti můžeme sledovat aktuální hodnotu indexu v poli (počáteční hodnota při prvním průchodu je nastavena na 0, není-li explicitně změněno parametrem start). K aktuální hodnotě indexu můžeme tedy uvnitř cyklu, kterým vypisujeme zaměstnance a jejich kontakty, přistupovat přes $smarty.section.zamestnanci.index.

index_prev

Obsahuje hodnotu o step menší, než je hodnota index. Tedy hodnota $smarty.section.jmeno.index_prev je rovna hodnotě $smarty.section.jmeno.index - step.

index_next

Opačný případ index_prev. Obsahuje hodnotu o step větší, než je hodnota index. Tedy hodnota $smarty.section.jmeno.index_next je rovna hodnotě $smarty.section.jmeno.index + step.

Pro jednoduchou demonstraci, jak tyto indexy fungují, použijeme tuto šablonu:

{section name="index_test" loop="10" step="2"}
{$smarty.section.index_test.index}
{$smarty.section.index_test.index_prev}
{$smarty.section.index_test.index_next}<br />
{/section}

Jednoduchý výstup:

0 -2 2<br />
2 0 4<br />
4 2 6<br />
6 4 8<br />
8 6 10<br />

iteration

Obsahuje hodnotu iterace cyklu, tedy po kolikáté je cyklus vykonáván. Při prvním průchodu se jedná o číslo 1, v každém dalším průchodu je obsah $smarty.section.jmeno.iteration inkrementován o jedna.

first

Vlastnost first nabývá hodnoty TRUE při prvním průchodu cyklu. Lze využít např. při tisku hlavičky tabulky uvnitř section.

last

Opak vlastnosti first, nabývá hodnoty TRUE při posledním průchodu cyklu. Lze využít např. při tisku patičky tabulky uvnitř section.

rownum

Tato vlastnost je pouze alias k iteration. Pracuje naprosto stejně.

loop

Obsahuje hodnotu parametru loop. V případě nastavení step na hodnotu 1 je shodný s počtem iterací. Při změně kroku to však neplatí a toto použití může vést k nečekaným chybám. K celkovému počtu iterací slouží total (viz dále).

show

Stejně jako loop obsahuje hodnotu parametru, v tomto případě parametru show. Tuto hodnotu lze využít v různých místech šablony, např. pro podmíněné výpisy v závislosti na tom, zda-li byl obsah cyklu vypsán, či nikoliv.

total

Jak jsme si již uvedli u vlastnosti loop, total obsahuje hodnotu celkového počtu iterací, které cyklus vykonal.

strip

Tato funkce funguje podobně jako modifikátor strip. Odstraňuje všechny bílé znaky mezi {section} a {/section}. Vše, co je uvnitř HTML tagů, tedy vše mezi < a > logicky ignoruje, aby nedocházelo k poškozování kódu. Použití je vhodné k minimalizování kódu. Dva příklady demonstrují použití na kódu, kde jsou všechny řádky uzavřeny v HTML značkách, a na kódu, kde je uzavřen blok generovaného textu.

{strip}
<table>
<tr>
<td>Lorem</td>
<td>Ipsum</td>
</tr>
</table> 
{/strip}

Výstupem této šablony bude:

<table><tr><td>Lorem</td><td>Ipsum</td></tr></table> 

A teď šablona bloku generovaného textu:

{strip}
<p>
Lorem ipsum dolor sit amet consectetuer cursus In consectetuer ligula nibh. 
Pretium hac justo et malesuada Morbi cursus consectetuer nulla Curabitur Nam. 
</p>
{/strip}

V tuto chvíli je funkce strip nepoužitelná, protože mezi bílé znaky patří nejen konce řádků, ale i mezery na konci řádků. Veškeré tyto znaky byly odstraněny a tím i náš text znehodnocen, konkrétně byla odstraněna mezera za tečkou první věty, což je patrné na výsledku:

<p>Lorem ipsum dolor sit amet consectetuer cursus In consectetuer ligula
nibh.Pretium hac justo et malesuada Morbi cursus consectetuer nulla Curabitur Nam.</p>

Závěr

V příštím díle se začneme seznamovat se speciálními funkcemi (custom functions).

Seriál Smarty, šablonovací systém (dílů: 6)

První díl: Smarty, šablonovací systém - 1 (úvod), poslední díl: Smarty, šablonovací systém - 6 (vestavěné funkce - 3).
Předchozí díl: Smarty, šablonovací systém - 5 (vestavěné funkce 2)

Diskuse k tomuto článku

[DarkCraft]

Tak jsme se dockali dalsiho dilu, perfektni. Moc dekuju autorovi za kvalitne napsany clanek, uz si ho tisknu a zakladam :)

[DarkCraft]

Jo jenom bych jeste opet upozornil, ze tento dil se zase nezobrazuje zde: http://www.abclinuxu.cz/serialy/smarty-sablonovaci-system

[Robert Krátký]

Tak to vidíte, co mi ta tlačenka dělá...

[Robo]

V dnešním článku navážeme na předchozí díly článku

dobra formulacia :)

[1122]

Smarty neoddeluji logickou vrstvu od prezentacni, to znamena ze obycejny koder by se v template nevyznal a museli byste piplacet za jineho, ktery se v tom hnusu vyzna, mnohem lepsi nez SMARTY je MVC pattern + XML + XSLT, proc nenapisete o tom? Smarty by se melo prejmenovat na Only4dummiesIamSmarty

[Toman]

Kazdy ma jiny vkus, pouziva jine prostredky atd. Znam spoustu profesionalnich spolecnosti zivicich se webdesignem, ktere Smarty Template Engine pouzivaji. Vzdyt Vam nikdo nebrani v napsani clanku na Vami vyzdvihovane tema, prosim, redakce abicka bude urcite rada.

[Zadek z Hulan]

Smarty je cierna ovca PHP. Kazda technologia, ktora je naviazana na jednu jedinu platformu, smrdi. Aj ked uznavam, ze Smarty bol kedysi dost popularny. Dnes uz je vyrazne badat prechod na XML+XSL, ktory (a) je platformovo nezavisly, (b) umoznuje cisty Model-View-Controller pristup, pretoze nezaserie kod PHP, (c) mozem odlahcit server a posunut XSLT transformacie na clienta, vacsina browserov to dnes zvlada, (d) znizuje to naklady, pretoze XSL sheet vyrobim z XHTML rychlo a pohodlne, nemusim zamestnavat specialistu na Smarty.

[Toman]

Tak jeste abych navazoval na dily nasledujici

[Oldis]

V clanku mi chyby funkce {cycle values="xxx,yyy"}

[Toman]

V dalsim dile, protoze funkce {cycle} patri mezi tzv. custom functions, tedy specialni funkce, v tomto dile jsou popsany built-in funkce, tedy vestavene funkce. V dalsich dilech bude probrano: {assign}, {counter}, {cycle}, {debug}, {eval}, {fetch}, {html_checkboxes}, {html_image}, {html_options}, {html_radios}, {html_select_date}, {html_select_time}, {html_table}, {mailto}, {math}, {popup}, {popup_init} a {textformat}.