Latte 2.9: to nejlepší nakonec

Letos již byly vydány tři klíčové verze Latte:

• Latte 2.6 s volitelným zřetězením a uživatelskými funkcemi
• Latte 2.7: typy kam se podíváš a batch
• Latte 2.8 přinášející opevnění uvnitř šablony

Ale je to nová verze 2.9, která přináší nejvíce nových věcí. Pojďme se na ně podívat!

{foreach} + {else}

Značka {foreach} může mít volitelnou klauzuli {else}, jejíž text se zobrazí, pokud je pole kterým iterujeme prázdné:

<ul>
    {foreach $people as $person}
        <li>{$person->name}</li>
    {else}
        <li><em>Litujeme, v tomto seznamu nejsou žádní uživatelé</em></li>
    {/foreach}
</ul>

{skipIf}

Je velmi podobný {continueIf}, ale neinkremetuje počítadlo. Při výpisu $iterator->counter a přeskočení některých položek tedy v číslování nejsou žádné díry. A co je nejdůležitější, klauzule {else} bude vykreslena, když přeskočíte všechny položky. Cool!

<ul>
    {foreach $people as $person}
		{skipIf $person->age < 18}
        <li>{$iterator->counter}. {$person->name}</li>
    {else}
        <li><em>Litujeme, v tomto seznamu nejsou žádní dospělí uživatelé</em></li>
    {/foreach}
</ul>

$iterátor: counter0 & parent

Byly přidány dvě nové vlastnosti objektu $iterator. Vlastnost $iterator->counter0, sourozenec čítače $iterator->counter, ale počítaná od nuly.

A vlastnost $iterator->parent, která vrací iterátor obklopující aktuální.

{try} & {else} & {rollback}

Úžasná nová funkce, díky níž je extrémně snadné vytvářet robustní šablony. Pokud při vykreslování bloku {try} dojde k výjimce, celý blok bude přeskočen a vykreslování bude pokračovat až po něm:

{try}
	<ul>
		{foreach $twitter->loadTweets() as $tweet}
  			<li>{$tweet->text}</li>
		{/foreach}
	</ul>
{/try}

Volitelná klauzule {else} je vykreslena při výjimce:

{try}
	<ul>
		{foreach $twitter->loadTweets() as $tweet}
  			<li>{$tweet->text}</li>
		{/foreach}
	</ul>
	{else}
	<p>Sorry, unable to load tweets.</p>
{/try}

Blok {try} lze také zastavit a přeskočit ručně pomocí {rollback}. Nemusíte tak předem kontrolovat všechna vstupní data a během vykreslování se můžete rozhodnout, zda má smysl objekt vykreslit:

{try}
<ul>
    {foreach $people as $person}
 		{skipIf $person->age < 18}
       <li>{$person->name}</li>
    {else}
		{rollback}
    {/foreach}
</ul>
{/try}

Je také možné definovat vlastní obslužný handler výjimek, třeba pro logování:

$latte = new Latte\Engine;
$latte->setExceptionHandler(function (\Throwable $e) {
	...
});

{ifchanged}

Zkontrolujte, zda se hodnota změnila od poslední iterace ve smyčce (for, foreach, while).

Pokud je ve značce předána jedna nebo více proměnných, zkontroluje, zda se nějaká proměnná změnila. Například následující příklad vytiskne nadpis s prvním písmenem pokaždé, když se změní při výpisu jmen:

{foreach ($names|sort) as $name}
    {ifchanged $name[0]} <h2>{$name[0]}</h2> {/ifchanged}

	<p>{$name}</p>
{/foreach}

Pokud není zadán žádný argument, zkontroluje vykreslený obsah oproti jeho předchozímu stavu a zobrazí jej pouze pokud se změnil. V předchozím příkladu tedy můžeme argument vynechat. Můžeme také použít n:atribut:

{foreach ($names|sort) as $name}
    <h2 n:ifchanged>{$name[0]}</h2>

	<p>{$name}</p>
{/foreach}

Značka {ifchanged} může mít také volitelnou klauzuli {else}, která se zobrazí, pokud se hodnota nezmění.

{embed}

Game-changer v dědičnosti bloků.

Embed je kombinace mezi dědičností {extends} a vložením {include}. Umožní vám vložit obsah jiné šablony a zároveň přepsat jakýkoli blok definovaný uvnitř zahrnuté šablony, jako při dědění šablon.

{embed 'article.latte', social: ['facebook', 'twitter', 'instagram']}

    {* tyto bloky definované v article.latte přepíšeme právě zde *}

    {block title}
		<div>Header Content</div>
	{/block}

	{block main}
        <div>Main Content</div>
    {/block}
{/embed}

Šablona article.latte:

<div class="article-component">
    <header>{block title}Default Header Content{/block}</header>

    <main>{block main}Default Main Content{/block}</main>

    <footer>{block footer}Default Footer Content{/block}</footer>

    {ifset $social}
        <ul class="social">
			<li n:foreach="$social as $item">{$item}</li>
        </ul>
    {/ifset}
</div>

Lokální bloky

Bloky jsou sdíleny mezi více šablonami, pokud jsou součástí hierarchie dědičnosti ({layout}) nebo pokud je importujeme ({import}). Někdy však v takových šablonách se hodí vytvořit blok (prostřednictvím {block} nebo {define}), který by neměl být k dispozici v jiných šablonách, ani by neměl přepisovat další bloky, pokud se jejich názvy shodují.

Řešením je označit takový blok jako lokální pomocí slova local před jménem:

{block local tree}
	This is local block
{/block}

{case 1, 2, 3}

Klauzule {case} nyní může obsahovat více hodnot:

{switch $status}
{case $status::NEW}<b>new item</b>
{case $status::SOLD, $status::UNKNOWN}<i>not available</i>
{/switch}

Protože {switch} v Latte používá striktní srovnání a nepotřebuje break, je nyní přesným ekvivalentem pro match z PHP 8.

{include block / file} & {ifset block}

Tag {include} lze použít k vložení bloků nebo souborů. Podobně lze {ifset} použít k testování existence proměnné nebo bloku. Latte pozná, že jde o blok, pokud se argument skládá pouze z alfanumerických znaků.

Nyní je možné rozlišit, že se jedná o blok resp. soubor, a to výslovným uvedením klíčového slova block resp. file, které je užitečné například v případě, že je název uložen v proměnné.

{include block $blockName}
{include file $file}
{ifset block $blockName} ... {/ifset}

{include block from file}

Nyní můžete pomocí značky {include} vložit pouze jediný blok ze souboru. Funguje také pro lokální bloky.

{include sidebar from 'template.latte'}

{include file with blocks}

Přímou náhradou za deprecated značku {includeblock}, která měla nevhodný název, je právě tato značka:

`{include 'template.latte' with blocks}`

Výchozí hodnoty v {define}

Parametry v {define} mohou mít výchozí hodnoty. Pokud žádnou neuvedete, je tak jako doposud null.

{define sidebar $class, $cols = 2}
	...
{/define}

Filtr a funkce clamp

Historicky se jedná o první výchozí vlastní funkci v Latte. Vrátí hodnotu omezenou na inkluzivní rozsah min a max.

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

{$level|clamp: 0, 255}

Filtr |sort

Filtr, který jednoduše seřadí pole:

{foreach ($names|sort) as $name}
	...
{/foreach}

Pole seřazené v obráceném pořadí:

{foreach ($names|sort|reverse) as $name}
	...
{/foreach}

Vliv PHP 8.0: pojmenované argumenty

Pro pojmenované argumenty ve značkách jako {include} nebo {link} můžete použít syntaxi podobnou PHP 8:

before
{include 'file.latte' arg1 => 1, arg2 => 2}
now
{include 'file.latte' arg1: 1, arg2: 2}

before
{link default page => 1}
now
{link default page: 1}

Navíc, pokud používáte PHP 8, můžete použít pojmenované argumenty uvnitř všech volání funkcí, jako je {=func(a: 10, b: 20)}

Z důvodu budoucí podpory pojmenovaných argumentů v modifikátorech je použití dvojtečky jako oddělovače argumentů označeno za deprecated. Místo dvojtečky použijte čárku: {$var|filter: a: 2} ⇒ {$var|filter: a, 2}

Vliv PHP 8.0: operátory ?-> a ??->

Latte přišlo s funkcí volitelného řetězení téměř před rokem. PHP 8 nyní přichází s něčím opravdu velmi podobným pod názvem nullsafe operator:

$var?->prop?->elem[1]?->call()?->item

Chování však není úplně stejné. Chování v PHP 8 generuje varování, pokud proměnná, vlastnost nebo index pole neexistuje (v uvedeném příkladu, pokud $var, $var->prop nebo elem[1] neexistuje). Pouze testuje, zda je hodnota rovna null.

Naproti tomu chování v Latte je podobné null coalescing operátoru ??. To znamená, že neexistující proměnná, vlastnost nebo index pole se nepovažují za chybu.

Latte 2.9 sjednocuje chování a operátor ?-> se nyní chová stejně jako v PHP, aby byl konzistentní. Ale předchozí chování nyní implementuje nový undefined-safe operátor ??->:

$var??->prop??->elem[1]??->call()

Je vůbec ještě něco, co v Latte chybí?