Latte funkce

V šablonách Latte můžeme kromě běžných PHP funkcí využívat i další speciální funkce, které rozšiřují možnosti při práci s daty a šablonami.

Použití

Funkce v Latte se používají stejně jako běžné PHP funkce a lze je využít ve všech výrazech:

<p>{clamp($num, 1, 100)}</p>

{if odd($num)} ... {/if}

Vlastní funkce můžete do Latte přidat takto:

$latte = new Latte\Engine;
$latte->addFunction('shortify', fn(string $s, int $len = 10) => mb_substr($s, 0, $len));

V šabloně pak tuto funkci můžete volat následovně:

<p>{shortify($text)}</p>
<p>{shortify($text, 100)}</p>

Funkce

clamp(int|float $value, int|float $min, int|float $max): int|float

Funkce clamp omezí hodnotu do zadaného inkluzivního rozsahu mezi $min a $max.

{=clamp($level, 0, 255)}

Viz také filtr clamp.

divisibleBy(int $value, int $by): bool

Funkce divisibleBy ověří, zda je číslo $value dělitelné číslem $by.

{if divisibleBy($num, 5)} ... {/if}

even(int $value): bool

Funkce even zkontroluje, zda je dané číslo sudé.

{if even($num)} ... {/if}

first(string|iterable $value): mixed

Funkce first vrací první prvek pole nebo první znak řetězce:

{=first([1, 2, 3, 4])}    {* vypíše 1 *}
{=first('abcd')}          {* vypíše 'a' *}

Viz také last, filtr first.

group(iterable $data, string|int|\Closure $by): array

Funkce group seskupí data podle zadaných kritérií.

V tomto příkladu se řádky v tabulce seskupují podle sloupce categoryId. Výsledkem je pole polí, kde klíčem je hodnota ve sloupci categoryId. Podrobný návod najdete zde.

{foreach group($items, categoryId) as $categoryId => $categoryItems}
    <ul>
        {foreach $categoryItems as $item}
            <li>{$item->name}</li>
        {/foreach}
    </ul>
{/foreach}

Viz také filtr group.

hasBlock(string $name): bool

Funkce hasBlock ověří, zda existuje blok s uvedeným názvem:

{if hasBlock(header)} ... {/if}

Viz také kontrola existence bloků.

last(string|array $value): mixed

Funkce last vrací poslední prvek pole nebo poslední znak řetězce:

{=last([1, 2, 3, 4])}    {* vypíše 4 *}
{=last('abcd')}          {* vypíše 'd' *}

Viz také first, filtr last.

odd(int $value): bool

Funkce odd zkontroluje, zda je dané číslo liché.

{if odd($num)} ... {/if}

slice(string|array $value, int $start, ?int $length=null, bool $preserveKeys=false): string|array

Funkce slice extrahuje část pole nebo řetězce.

{=slice('hello', 1, 2)}           {* vypíše 'el' *}
{=slice(['a', 'b', 'c'], 1, 2)}   {* vypíše ['b', 'c'] *}

Tato funkce funguje podobně jako PHP funkce array_slice pro pole nebo mb_substr pro řetězce (s fallbackem na iconv_substr v režimu UTF-8).

• Pokud je $start kladný, výsledek začíná od tohoto indexu od začátku pole/řetězce. Pokud je záporný, začíná se od konce.
• Pokud je $length kladný, výsledek bude obsahovat tolik prvků. Pokud je záporný, výsledek bude obsahovat všechny prvky kromě posledních $length prvků. Pokud není zadán, výsledek bude obsahovat všechny prvky od $start do konce.
• Parametr $preserveKeys určuje, zda zachovat původní klíče pole. Ve výchozím nastavení (false) jsou číselné klíče resetovány. Řetězcové klíče jsou vždy zachovány bez ohledu na toto nastavení.