Синтаксис

Синтаксис Latte народився з практичних потреб веб-дизайнерів. Ми шукали найзручніший синтаксис, за допомогою якого можна елегантно писати конструкції, які в інших випадках являють собою справжню проблему. Водночас усі вирази написані точно так само, як у PHP, тому вам не доведеться вивчати нову мову. Ви просто використовуєте те, що вже знаєте.

Нижче наведено мінімальний шаблон, що ілюструє кілька базових елементів: теги, n:attributes, коментарі та фільтри.

{* це коментар *}
<ul n:if="$items">               {* n:if is n:atribut *}
{foreach $items as $item}        {* тег, що представляє цикл foreach *}
	<li>{$item|capitalize}</li>  {* тег, що виводить змінну з фільтром *}
{/foreach}                       {* кінець циклу *}

Давайте докладніше розглянемо ці важливі елементи і те, як вони можуть допомогти вам створити неймовірний шаблон.

Теги

Шаблон містить теги, які керують логікою шаблону (наприклад, цикли foreach) або вихідними виразами. Для обох випадків використовується один роздільник { ... }, тому вам не потрібно думати про те, який роздільник використовувати в тій чи іншій ситуації, як в інших системах. Якщо за символом { слідує лапка або пробіл, Latte не вважає його початком тега, тому ви можете без проблем використовувати у своїх шаблонах конструкції JavaScript, JSON або правила CSS.

Дивіться огляд усіх тегів. Крім того, ви можете створювати власні теги.

Latte розуміє PHP

Усередині тегів можна використовувати вирази PHP, які ви добре знаєте:

• змінні
• рядки (включно з HEREDOC і NOWDOC), масиви, числа тощо.
• оператори
• виклики функцій і методів (які можуть бути обмежені пісочницею)
• відповідність
• анонімні функції
• зворотні виклики
• багаторядкові коментарі /* ... */
• і т.д.

Крім того, Latte додає кілька приємних розширень до синтаксису PHP.

n:attributes

Кожен парний тег, наприклад {if} … {/if}, що працює з одним елементом HTML, може бути записаний у нотації n:attribute. Наприклад, {foreach} у наведеному вище прикладі можна записати і так:

<ul n:if="$items">
	<li n:foreach="$items as $item">{$item|capitalize}</li>
</ul>

Функціональність тоді відповідає елементу HTML, у якому вона записана:

{var $items = ['I', '♥', 'Latte']}

<p n:foreach="$items as $item">{$item}</p>

Prints:

<p>I</p>
<p>♥</p>
<p>Latte</p>

Використовуючи префікс inner-, ми можемо змінити поведінку так, щоб функціональність застосовувалася тільки до тіла елемента:

<div n:inner-foreach="$items as $item">
	<p>{$item}</p>
	<hr>
</div>

Відбитки:

<div>
	<p>I</p>
	<hr>
	<p>♥</p>
	<hr>
	<p>Latte</p>
	<hr>
</div>

Або за допомогою префікса tag- функціональність застосовується тільки до HTML-тегів:

<p><a href="{$url}" n:tag-if="$url">Title</a></p>

Залежно від значення змінної $url буде виведено таке:

// when $url is empty
<p>Title</p>

// when $url equals 'https://nette.org'
<p><a href="https://nette.org">Title</a></p>

Однак n:attributes – це не тільки скорочення для парних тегів, є й деякі чисті n:attributes, наприклад, найкращий друг кодера n:class.

Фільтри

Див. короткий опис стандартних фільтрів.

Latte дозволяє викликати фільтри за допомогою знака труби (пробіл перед фільтром допускається):

<h1>{$heading|upper}</h1>

Фільтри можуть бути з'єднані в ланцюжок, у цьому разі вони застосовуються в порядку зліва направо:

<h1>{$heading|lower|capitalize}</h1>

Параметри поміщаються після імені фільтра через двокрапку або кому:

<h1>{$heading|truncate:20,''}</h1>

Фільтри можуть бути застосовані до виразу:

{var $name = ($title|upper) . ($subtitle|lower)}

На блоці:

<h1>{block |lower}{$heading}{/block}</h1>

Або безпосередньо на значенні (у поєднанні з {=expr} тег):

<h1>{='  Hello world  '|trim}<h1>

Коментарі

Коментарі пишуться таким чином і не потрапляють у виведення:

{* це коментар у Latte *}

Коментарі PHP працюють усередині тегів:

{include 'file.info', /* value: 123 */}

Синтаксичний цукор

Рядки без лапок

Для простих рядків лапки можна не ставити:

as in PHP:   {var $arr = ['hello', 'btn--default', '€']}

abbreviated: {var $arr = [hello, btn--default, €]}

Прості рядки – це рядки, які складаються виключно з літер, цифр, підкреслень, дефісів і крапок. Вони не повинні починатися з цифри і не повинні починатися або закінчуватися дефісом. Він не повинен складатися тільки із великих літер і знаків підкреслення, тому що тоді він вважається константою (наприклад, PHP_VERSION). І він не повинен перетинатися з ключовими словами and, array, clone, default, false, in, instanceof, new, null, or, return, true, xor.

Короткий тернарний оператор

Якщо третє значення тернарного оператора порожнє, його можна опустити:

as in PHP:   {$stock ? 'In stock' : ''}

abbreviated: {$stock ? 'In stock'}

Сучасна ключова нотація в масиві

Ключі масиву можуть бути записані аналогічно іменованим параметрам при виклику функцій:

as in PHP:   {var $arr = ['one' => 'item 1', 'two' => 'item 2']}

modern:      {var $arr = [one: 'item 1', two: 'item 2']}

Фільтри

Фільтри можна використовувати для будь-якого виразу, просто помістіть все в дужки:

{var $content = ($text|truncate: 30|upper)}

Оператор in

Оператор in може бути використаний для заміни функції in_array(). Порівняння завжди суворе:

{* like in_array($item, $items, true) *}
{if $item in $items}
	...
{/if}

Опціональний ланцюжок із невизначено-безпечним оператором

Оператор undefined-safe ??-> схожий на оператор nullsafe ?->, але не викликає помилки, якщо змінна, властивість або індекс взагалі не існує.

{$order??->id}

Це спосіб сказати, що коли $order визначена і не є null, $order->id буде обчислено, але коли $order є null або не існує, зупиніть наші дії і просто поверніть null.

Ви можете виявити, що використовуєте ?-> для заміни великої кількості коду, який виконує повторювані перевірки на нуль:

{$user??->address??->street}
// roughly means isset($user) && isset($user->address) ? $user->address->street : null

Вікно в історію

За свою історію Latte придумав кілька синтаксичних цукерок, які з'явилися в самому PHP кількома роками пізніше. Наприклад, у Latte можна було записувати масиви у вигляді [1, 2, 3] замість array(1, 2, 3) або використовувати оператор nullsafe $obj?->foo задовго до того, як це стало можливим у самому PHP. У Latte також з'явився оператор розширення масиву (expand) $arr, який є еквівалентом сьогоднішнього оператора ...$arr з PHP.

Обмеження PHP у Latte

У Latte можна писати тільки PHP-вирази. Тобто, ви не можете оголошувати класи або використовувати керуючі структури, такі як if, foreach, switch, return, try, throw та інші, замість яких Latte пропонує свої теги. Ви також не можете використовувати атрибути, зворотні знаки або магічні константи, тому що це безглуздо. Ви навіть не можете використовувати echo, include, require, exit, eval, unset, тому що це не функції, а спеціальні конструкції мови PHP, а отже, не вирази.

Однак ви можете обійти ці обмеження, активувавши розширення RawPhpExtension, яке дає змогу використовувати будь-який PHP-код у тезі {php ...} під відповідальність автора шаблону.