Šablony a jak vylepšit makro {attr …}

Jelikož je v dokumentaci už dlouho napsáno, že je to ve vývoji, tak za sebe píšu, že já ho nepoužívám vůbec ;).

Používám ho jen pokud chci vepsat celé pole hodnot do parametru, většinou class:

<li{attr class($classes)}>

Do pole $classes předtím nacpu třídy jako last, first, active aj. A protože se může stát, že pole zůstane prázdné, takto se to dá elegantně vypsat.

V ostatních případech si vystačím s {if} makrem… (i když to ve výsledku nevypadá tak hezky a čistě jako s {attr})

Editoval Blizzy (19. 8. 2009 11:52)

Hmmm, já to taky v životě na nic jiného než class nepoužil (no jednou na style, ale to se nesmí říkat bo style přece frajeři nepoužívají).

No a právě tohle se mi nelíbí:

<li{attr class('first', $iterator->isFirst()) class('last', $iterator->isLast())}>

Schválně nebudu prozrazovat svůj tip na lepší syntax, ať neovlivňuju a zeptám se – napadá vás nějaká lepší syntax?

Sázím své virtuální boty, že David myslí parametr n:class, resp. n:classIf. :-)

Teda nelíbí se mi ani jedno ;)

Syntax by měla být co nejvíce HTML-like. Dokonce si myslím, že by nebylo od věci, aby šablonovací systém na výskyt maker uvnitř prostoru HTML tagu (a mimo hodnoty atributů) dokázal upozorňoval jako na něco špatného. Např. <div {foreach...}...{/foreach}>.

Ale k těm atributům. Obecně se dá říct, že existují dva případy:

1. atribut s hodnotou, který se vykreslí pouze pokud je splněna určitá podmínka
   • speciální případ, kdy samotná hodnota je zároveň i podmínkou (vykresli title="{$title}" když existuje $title)
2. atribut tvořený seznamem volitelných hodnot, který se vykreslí pouze pokud existuje alespoň jedna hodnota
   • v HTML takových atributů existuje celá řada, ale v praxi se z nich využije v podstatě jen class

Návrh syntaxe:

ad 1)

<span {$cond?}title="Nejaky title" lang="cs">...</span>

<span title="Nejaky title"{?$cond} lang="cs">...</span> // tohle je kolidující s {? ... }

<span {$cond:}title="Nejaky title" lang="cs">...</span>

<span title="Nejaky title"{:$cond} lang="cs">...</span>

atd...

ad 2)

Pokud by vzniklo n:class, bylo by potřeba použít PHP-like zápis, tedy PHP s doplňováním uvozovek kolem identifikátorů:

<li n:class="item, odd => $iterator->odd, last => $iterator->last">

Druhou možností je rozšířit bod č.1, aby fungoval i uvnitř hodnot atributů:

<li class="item {$iterator->odd?}odd {$iterator->last?}last">

<li class="item odd{?$iterator->odd} last{?$iterator->last}"> // tohle je kolidující s {? ... }

<li class="item {$iterator->odd:}odd {$iterator->last:}last">

<li class="item odd{:$iterator->odd} last{:$iterator->last}">

Zde by jen bylo trošku implementačně náročnější zajistit, aby nevznikal prázdný class="".

Ale když už by se šlo touto cestou, taky by bylo možná vhodnější řešení č. 1 upravit tak, aby se podmínky používali také jen uvnitř atributů, na speciálním místě:

<span title="{?$cond}Nejaky title" lang="cs">...</span> // tohle je kolidující s {? ... }

<span title="Nejaky title{$cond:}" lang="cs">...</span>

<span title="{:$cond}Nejaky title" lang="cs">...</span>

Mne je najviac sympatická otázniková notácia:

<span{if $selected} class="selected"{/if}>...</span>
<!-- vs. -->
<span {$selected?}class="selected">...</span>

Prispieva k čitateľnosti a prefixová forma mi príde prirodzenejšia ako suffixová, píšeme predsa if <cond> then <smth>;. Je podobná makru {?...}, ale myslím, že to pomaly zo šablón vymizne…

Zápis n:class je podľa mňa ideálny, všetky n:* atribúty používajú vnútri php-like syntax, takže tu nemám čo dodať.

David Grudl napsal(a):

Ale když už by se šlo touto cestou, taky by bylo možná vhodnější řešení č. 1 upravit tak, aby se podmínky používali také jen uvnitř atributů, na speciálním místě:

Ak bude podporovaná syntax vnútri atribútov, myslím, že špeciálne miesto nie je nutné, nasledovné zápisy by mali byť ekvivalentné:

<span {$selected?}class="selected">...</span>
<!-- vs. -->
<span class="{$selected?}selected">...</span>

Je fakt, že v prípade viacerých tried by to bolo trochu komplikované…

<span {$selected?}class="selected hilite">...</span>
<!-- vs. -->
<span class="{$selected?}selected {$selected?}hilite">...</span>

Ale tento príklad je dosť umelý a nevidím jeho praktické využitie…

Jedna syntaxe pro inline podmínky je všem známá – ternární operátor – proto bych se co nejvíce držel jej. A určitě bych dal takovým makro-atributům nějaký prefix.

<!-- Že se jedná o atribut se dá najevo závorkami: -->
<span n:{class}="$selected ? selected : not-selected"></span>

<!-- V případě že chceme více tříd, tak se použije grouping pomocí závorek: -->
<span n:{class}="$selected ? (selected hilite) : not-selected"></span>

<!-- Větěv za `:` nemusí být přítomna: -->
<span n:{class}="$selected ? selected"></span>

<!-- A pokud je sama proměnná podmínkou: -->
<span n:{title}="$title?"></span>
<!-- možná pro zvýraznění, že chceme vypsat proměnnou před otazníkem: -->
<span n:{title}="$title?<"></span>

<!-- Více podmínek: -->
<span n:{class}="($selected ? selected) ($iterator->last ? last)"></span>

Nezaváděl bych další magickou wtf syntaxi.

Všechny macra fungujou principem {nazevMacra...} nebo n:nazevMacra="..."

Nezaváďel bych další nejakou šílenost která moc nedává smysl: mluvim o tech řešeních typu class="{$cond?}neco neco2 {$cond?}neco3" kdy to ve vysledku ovlivní i vypsání/nevypsání class=""

K jednotlivím davidovým návrhúm:

<span {$cond?}title="Nejaky title" lang="cs">...</span>
<span {$cond:}title="Nejaky title" lang="cs">...</span>
<span title="Nejaky title"{:$cond} lang="cs">...</span>

Neliší se od {if $cond}title="Nejaky title"{/if} if je jen o par znaku delsi, a nema to wtf faktor, a ani nekompabilitu. A vlastně to ani nic neřeší.

<span title="Nejaky title"{?$cond} lang="cs">...</span> // tohle je kolidující s {? ... }

Není spětně kompatibilní takže o ní ani nemuzu uvažovat (ale platí pro ní to samé co pro předešlé)

<li n:class="item, odd => $iterator->odd, last => $iterator->last">

Tohle je aspoň trošku rozumné, a mluvili jsme o tom i na poslední sobotě.

<li class="item {$iterator->odd?}odd {$iterator->last?}last">
<li class="item odd{?$iterator->odd} last{?$iterator->last}"> // tohle je kolidující s {? ... }
<li class="item {$iterator->odd:}odd {$iterator->last:}last">
<li class="item odd{:$iterator->odd} last{:$iterator->last}">

Tohle je prostě wtf, není to ani klasicke macro, zavádí to novou syntaxy, a ovlivnuje to něco mimo macro.

Co je špatného na zavádění nové syntaxe?

Zkuste si projít všechny šablonovací systémy na wiki – to je bída, tam těžko hledat nějakou inspiraci. Ale jakmile jste leaderem, tak prostě vymýšlíte nová řešení. Nette je framework odpočátku založený na hledání nových cest.

Cílem je: velmi pohodlný šablonovací systém se syntaxí srozumitelnou pro neprogramátora. Od tohoto konce se musí začít a pak jen hledat cesty, jak to implementovat. Takže otázka zní:

• jak by se nám psaly šablony hezky?
• co v nich musíme dnes řešit krkolomně?

Tohle vám nepřijde dost dobré?

<li class="{= $active ? 'active' : ''}">obsah</li>

David Grudl napsal(a):

<span>...</span>
<!-- vs. -->
<span class="">...</span>

Jakej je mezitim v praxi rozdíl?

Honza M. napsal(a):

Jakej je mezitim v praxi rozdíl?

V případě atributu class pouze vizuální, ale například u povinného atributu alt je

<img src="..." alt="">  OK

<img src="...">  CHYBA

nebo naopak u atributu s předepsaným formátem je:

<span id="">  CHYBA

nebo

<span lang="">  CHYBA

Vyzkoušel jsem patch od Jakuba, funguje skvěle a syntaxe se mi zdá velmi srozumitelná. Dá se ale nějak zapsat pomocí {} ?

Díky, myslel jsem si to.

Honza Marek napsal(a):

<li class="{= $active ? 'active' : ''}">obsah</li>

Tohle by se mi moc líbilo, mělo by to širší uplatnění.

knyttr napsal

vsak ale to funguje ;), to Honza napisal ako priklad niecoho co uz facha a je zaroven dost elegantne (imho)

vrana napsal(a):

<li n:class="item, odd => $iterator->odd, last => $iterator->last">

Tohle je podle mě to pravé.

+1

riesenie od jakubkulhan cize zapis na viac riadkov atributu sa mi zda krkolomne, davat bacha na " a pod… to je o hubu a z pohladu kodera asi nemozne. riesenie od Jakuba Vranu povazujem opticky za najlepsie s tym ze si viem predstavit nieco taketo

<?php
	<li n:class="item, odd => $iterator->isOdd(), admin => $user->isInRole(...), special => CustomClass::isSpecial()">
?>

v podstate nahod classu ak TRUE.

Editoval newPOPE (22. 10. 2010 14:57)

Tak to mi přijde jako fakt ale hnus.

hason napsal(a):

V šablonovacím systému, který používám bych napsal:

Díky za odpověď, je zajímavé se podívat, jak to řeší jiné systémy. Z mého pohledu to je bída, nechci se tím inspirovat a hledám (čti hledáme) řešení jiné. Opakuji tedy zase totéž. Alespoň se můžeš znovu pobavit.

Zajímalo by mě, jak by paranoiq přepsal příklad z Twigu do Latte tak, aby to bylo „jednoduché“ a „intuitivní“. // Dobře se to kritizuje šablonovací systém z neintuitivnosti, když ho člověk nezná. :) (Edit: Má omluva, pokud se pletu; hádám.) Na syntaxi Twigu jsem se díval kdysi dávno a až na „cycle“ filter (jo, práskám se do čela, když teď vím, co znamená :]) jsem s tím neměl problém – krom toho, že je to celkem střelená ukázka. :)

___

Abych byl aspoň trochu konstruktivní, hodím pseudokód možného řešení – aneb nestačil by pouhý filter, který by vzal pole?

<li{['odd' => $iterator->isOdd(), 'bla' => $item->isBla()]|class}>

Editoval Yrwein (22. 10. 2010 17:02)

Co takhle kombinace jakuba & jakuba?

n:(attr) = "value1 => condition value2 => condition ..." //povinné (alt...)
n:[attr] = "value1 => condition value2 => condition ..." //nepovinné ...

Editoval jasir (22. 10. 2010 17:08)

Protože class je nejčastější případ použití, tak udělám n:class (a n:href) a pro ostatní atributy syntaxi ještě vymyslíme. Nejkonzistentnější by asi bylo n:attr-xxx

Yrwein napsal(a):
Zajímalo by mě, jak by paranoiq přepsal příklad z Twigu do Latte tak, aby to bylo „jednoduché“ a „intuitivní“.

uvedený příklad třeba tak. (místo „:)“ bych samozřejmě použil nějaký normální název třídy)

<li n:class="ahoj, $selected ? jsem : nejsem, leader, smajlik => $iterator->last">

všimni si, že s navrhovanou syntaxí se obejdu bez cyklování, filtrování a joinování – prostě v šabloně neprogramuju

Dobře se to kritizuje šablonovací systém z neintuitivnosti, když ho člověk nezná. :)
(Edit: Má omluva, pokud se pletu; hádám.) Na syntaxi Twigu jsem se díval kdysi dávno a až na „cycle“ filter (jo, práskám se do čela, když teď vím, co znamená :]) jsem s tím neměl problém – krom toho, že je to celkem střelená ukázka. :)

hádáš správně šablony symfony nadrcené nemám. z ukázky jsem ale pochopil, že funkčnost o které se tu bavíme prostě twig nemá a kodér si jí musí v šabloně vyrábět pokaždé znovu na koleně. takovéhle složitosti do šablon nepatří

David Grudl napsal(a):
Beru teda za domluvenou následující syntax, ok?
<li n:class="item, odd => $iterator->odd, last => $iterator->last, $selected ? selected : notselected">

mohla by se prohodit podmínka a hodnota, aby byla podmínka vždy na začátku. zmizí pak jedno WTF

<li n:class="item, $iterator->odd => odd, $iterator->last => last, $selected ? selected : notselected">

nebo ještě jednodušeji – zahodit šipku a použít otazník. pak už nejsou dvě formy zápisu ale jen jedna u které lze vynechat část za dvojtečkou. pro tuhle verzi hlasuju :]

<li n:class="item, $iterator->odd ? odd, $iterator->last ? last, $selected ? selected : notselected">

Editoval paranoiq (23. 10. 2010 0:30)

než jsi reagoval už jsem svůj návrh poupravil. bylo to wtf. hodilo by se to pokud by se to skutečně chovalo jako zkrácený ternární operátor v PHP – tedy pro dosazení defaultní hodnoty: $hodnota ?: defaultni. jinak by to mátlo

Bude i fungovat tohle:

<a n:class="foo, ($iterator->first ? first), ($foo->bar ? bar : baz)">Foo</a>

Pokud by někdo chtěl, aby se atribut class vložil, i když bude prázdný, tak by se to mohlo dát udělat prázdným řetězcem. Tedy n:class=", ($odd ? odd)". Nevím, jestli to současná implementace podporuje.