Smarty Template Engine 29.díl - Funkce XIII.
Uživatelské funkce
{popup_init}
Pomocí této funkce integrujeme do své šablony knihovnu overLib pro po-pup okna. Používají se pro contextové informace a jako tzv. Tooltipy. Pro používání platí několik základních pravidel.
- může být použito pouze jednou v celé šabloně a musí být volána v hlavičce html_šablony, tedy mezi tagy head
- Popup využívá knihovnu overLib, informace naleznete zdehttp://www.bosrup.com/web/overlib/
- Tato funkce netvoří validní kód dle XHTML strict!!. Pro zvalidnění je třeba dopsat tagy v pořadí div, head
{text_format}
Poslední, ale zároveň jednou z nejdůležitějších a nejpoužívanějších funkcí je ta na úpravu textu. Jako u všech předešlých nahrazuje ekvivalentní funkce v PHP. Ale každý kodér tuto funkci dozajista ocení, protože může text předaný z aplikační logiky osekávat a upravovat text k obrazu svému. „text_format“ je funkcí blokovou, tedy vyžaduje uzavření modifikovaného textu mezi dva tagy, z níž ten druhý blok ukončuje. Parametry funkce jsou následující:- style – definování CSS stylu, defaultně: ´´ (nepovinný)
- indent – velikost odsazení všech řádků textu, požaduje číslo. Defaultně: 0 (nepovinný)
- indent_first - nastavuje velikost odsazení prvního řádku v textu, požaduje číslo, defaultně: 0 (nepovinný)
- indent_char – znak/znaky jímž mý být text odsazen, jako základní hodnota je nastavena mezera, defaultně: ´ ´ (nepovinný)
- wrap – zarovnání textu zprava, tedy po kolika znacích má na každém řádku dojít k ukončení výpisu, defaultně: 80 (nepovinný)
- wrap_char – nastavuje znak, pomocí něhož ukončíme text na řádku pomocí funci „wrap“, defaultně: (nepovinný)
- wrap_cut – pokud nastavíme na true, funkce přetékající znaky odstraní, požaduje booleanovské false/true defaultně: ´´ (nepovinný)
- assign – přiřazení proměnné z aplikační logiky, defaultně: ´´ (nepovinný)
Pro příklad využijme následující index.php
index.php
<?php
require_once("./hlavicka.php");
$smarty->assign('text', "Poslední, ale zároveň jednou z nejdůležitějších a nejpoužívanějších funkcí je ta na úpravu textu. Jako u všech předešlých nahrazuje ekvivalentní funkce v PHP. Ale každý kodér tuto funkci dozajista ocení, protože může text předaný z aplikační logiky osekávat a upravovat text k obrazu svému. „text_format“ je funkcí blokovou, tedy vyžaduje uzavření modifikovaného textu mezi dva tagy, z níž ten druhý blok ukončuje. Parametry funkce jsou následující:");
$smarty->display('index.tpl');
?>
index.tpl
{include file='./hlavicka.tpl' hlavicka='Smarty Template Engine'}
<p>
{textformat indent=10 wrap_char=" enter <br/>" wrap=10}
{$text}
{/textformat}
</p>
{include file='./paticka.tpl'}
V následujícím příkladě tedy nastavíme velikost jednoho řádku na 10 znaků a každý takovýto řádek ukončíme mezerou, nápisem: enter a tagem pro odřádkování.
Tím jsme tedy ukončili přehled všech uživatelských funkcí. Jejich oficiální dokumentaci naleznete na následující internetové stránce:
http://smarty.net/manual/en/language.custom.functions.php
2024 ©