Latte 3.1 – pojďte otestovat RC

Už jsou to neuvěřitelné tři roky od vydání Latte 3.0. Tehdy jsem knihovnu přepsal úplně odznova, obsahuje sofistikovaný PHP a HTML lexer, parser a kompilátor.

Časem se nashromáždilo několik věcí, které bych rád změnil, upravil nebo odstranil, a proto přišel čas na vydání verze 3.1.

Předesílám, že změny se týkají okrajových záležitostí a měla by být zachována plná kompatibilita, tj. na úpravy Latte upozorní jen vyhozením informační notice.

Jestli jsou vaše šablony kompatibilní se dá jednoduše ověřit pomocí Linteru. Já jsem třeba ve všech svých šablonách ve všech projektech musel udělat jen dvě drobné úpravy.

Takže co bych chtěl do verze 3.1 dát:

Nové features:

• chytré HTML atributy – viz https://forum.nette.org/…eji-do-latte
• n:attr kontroluje, jestli jsou názvy atributů platné
• přidáno n:elseif
• přidána syntax <div n:if={$foo}> (jako alternativa <div n:if="$foo">), kde je možné používat uvnitř hodnoty dvojité a jednoduché uvozovky
• přidán nullsafe filter $foo?|upper
• content-type based on file extension – content type šablony se detekuje z přípony, viz dále

Změny:

• strictTypes is enabled by default: tedy že šablony začnou declare(strict_types=1) (dá se to samozřejmě vypnout, i v konfiguraci)
• globální konstanty bez lomítka jako FOO je potřeba psát \FOO, tím se přehledně odliší od řetězce FOO
• komplexní výrazy ve značkách jako include, embed apod psát v závorkách: {include ($a ? 'a.latte' : 'b.latte')}

Zrušení:

• používání proměnných $this a $__* v šablonách – jsou vyhrazené pro systémové věci
• undefined unsafe operator ??-> – beru jej jako historický relikt vzniklý před nullsafe ?-> operátorem
• Latte\Runtime\Filters::$dateFormat – vadí mi, že jde o statickou proměnnou
• Engine::addFilterLoader() is deprecated – beru to jako historický relikt, žádná jiná oblast v Latte nemá loader

A ještě pár komentářů:

ad n:attr a nevalidní názvy atributů: tady Latte rovnou vyhodí výjimku, nicméně vím, že to třeba rozbíjí Ublaboo Datagrid, který používá <input n:attr="'rowspan=2' => $bool">, tj. jako název atributu uvádí celý atribut i s hodnotou. Tím ale využívá sideefekt, správný zápis by měl být <input n:attr="rowspan => $bool ? 2"> a pak lze název rowspan validovat. Bohužel tyto dynamické věci se nedají kontroloval pomocí Linteru.

Mimochodem, s chytrými atributy zmizí potřeba používat na takové věci n:attr a bude stačit <input rowspan="$bool ? 2">

S návrhem odlišit globální konstanty přišel @mesour, protože mu to zjednoduší parser v PhpStorm, ale musím říct, že to je pomoc i pro mě, protože si sám nejsem úplně jistý, co Latte chápe jako řetězec a co jako konstantu. Když se napíše \FOO, je to jasné.

Rozlišovat content-type podle přípony souboru znamená, že když vykreslím šablonu foo.xml.latte, tak bude automaticky parsovaná jako XML, bez nutnosti uvést {contentType ...} na začátku. Ale taky to znamená, že můžu v šabloně napsat <script>{include script.js}</script> a script.js se bude chápat jako čistý text a vůbec se v něm nebude parsovat Latte. (tohle nechám do další verze)

---

Všechny featury jsou implementované a bude fajn, když aktuální verzi vyzkoušíte. Minimálně si Linterem projeďte své šablony. Protože nic není dáno a než vyjde verze 3.1 lze cokoliv změnit. Ale na pozdější reklamace nebude brán zřetel :-)

composer require latte/latte:^3.1.x-dev