Zobrazenie zdroja stránky Symfony šablóny (templates)

<small>'''[[:Kategória:Symfony dokumentácia|Symfony dokumentácia - hlavná stránka]]''' &rarr;  '''Symfony šablóny (templates)'''</small>
---- 
Vytváranie a využívanie šablón.

 [http://symfony.com/doc/current/templating.html Templates - original documentation]

Kontrolér vybavuje požiadavky (request) a zvyčajne to končí vytvorením odpovede v šablóne. 

V praxi kontrolér deleguje ťažkú prácu na iné miesta, takže kód môže byť testovaný a opakovane využívaný. Ak kontrolér potrebuje vytvoriť HTML, CSS alebo iný obsah, prácu dáva motoru šablón.

V tejto kapitole sa naučíme ako písať šablóny, ktoré zobrazujú odpovede užívateľovi, naplnia obsah e-mailov, naučíme sa skratky, rozumné spôsoby rozširovania šablón a ako opakovane využívať kód.

== Šablóny ==

Typické šablóny sú textové výstup - mix kódov html, php. Symfony prináša silný nástroj [http://twig.symfony.com/ twig]. V mnohých ohľadoch prináša viac výhod než čísté php. Twig definuje tri typy špeciálnych príkazov:

<pre>{{ ... }}</pre>

'''Povedz niečo''', zobrazí obsah premennej, výsledku a podobne.

<pre>{% ... %}</pre>

'''Vykonaj niečo''': je to '''tag''', ktorý kontroluje logiku v šablónach, napríklad cyklus.

<pre>{# ... #}</pre>
'''Niečo okomentuj''', niečo ako php /* */ komentár, takisto môže byť použitý na viacero riadkov.

Twig prichádza aj s '''funkciami''', ktoré zmenia výstup pred zobrazením, napríklad nasledujúci kód zmení text na veľké písmená: <pre>{{ title|upper }}</pre>. Twig má dlhý zoznam [http://twig.sensiolabs.org/doc/tags/index.html tag-ov], [http://twig.sensiolabs.org/doc/filters/index.html filtrov] a [http://twig.sensiolabs.org/doc/functions/index.html funkcií]. Môžete si vytvárať ''vlastné'' filtre, funkcia (a viac)  pomocou [http://symfony.com/doc/current/templating/twig_extension.html twig extension].


Kód sa podobá jazyku php. Napríklad for s funkciou cycle() s ukážkou zobrazenia odlišne párne a nepárne riadky výstupu.

<pre>
{% for i in 1..10 %}
    <div class="{{ cycle(['even', 'odd'], i) }}">
      <!-- tu príde nejaký HTML kód -->
    </div>
{% endfor %}
</pre>


Užitočné výpis premennej, poľa

<pre>
{{  line|json_encode(constant('JSON_PRETTY_PRINT')) }}
{{  dump(line }}
</pre>

=== Caching Twig šablón ===

== Dedenie v šablónach a rozvrhnutie ==

=== Prispôsobivý web pre mobily ===
Pre responsívne správanie treba mať v base.html.twig:
 <meta name="viewport" content="width=device-width, initial-scale=1.0">

== Pomenovanie a umiestnenie šablón ==

== Značky a pomocníci (Tags and Helpers) ==
Nástroje na bežné práce v šablónach. Niektoré tagy už poznáme ({% block %} a  {% extends %}).

=== Vloženie inej šablóny ===

=== Prepojenie na stránky (Linking to Pages) ===
Vytváranie prepojení na iné stránky (link) je veľmi častá práca v prostredí šablón. Namiesto písania celej URL použijeme funkciu <code>path</code> (alebo <code>router</code> PHP pomocníka). Výhoda je zrejmá, zmenou konfigurácie URL nie je treba editovať každé prepojenie.

Ak sme definovali meno hlavnej stránky ako "homepage" prepojenie vyzerá takto:
<pre>
<a href="{{ path('homepage') }}">Hlavná stránka</a>
</pre>

.. pre vzhľad pripomínajúci tlačidlo to môže byť aj takto:

<pre>
<form>
<button formaction="{{ path('homepage') }}">Hlavná stránka</button>
</for>
</pre>

=== Prepojenie na (Linking to Assets) ===

== Myšlienky na záver ==

== Naučte sa viac ==

* [[Ako napísať vlastné twig extenzie]]
* [[Twig, entity a relačné vzťahy]]

[[Kategória:Symfony dokumentácia]]