Větvička (stroj šablony) - Twig (template engine)

Větvička

Původní autoři	Armin Ronacher,[1] Fabien Potencier
Vývojáři	SensioLabs
První vydání	12. října 2009 (2009-10-12)
Stabilní uvolnění	3.1.1[2] / 27. října 2020; Před 42 dny (27. října 2020)
Úložiště	github.com/ twigphp/Větvička
Napsáno	PHP
Operační systém	Cross-platform
Typ	Šablona motoru
Licence	Licence BSD
webová stránka	větvička.symfony.com

Větvička je stroj šablony pro Programovací jazyk PHP. Jeho syntaxe pochází z Jinja a Django šablony.^[3] Je to produkt s otevřeným zdrojovým kódem^[4] licencováno pod a Licence BSD a udržuje Fabien Potencier. Počáteční verze byla vytvořena uživatelem Armin Ronacher. Symfony Rámec PHP je dodáván s dodávanou podporou pro Twig jako jeho výchozí stroj šablon od verze 2.^[5]

Funkce

• komplexní kontrolní tok
• automatický únik
• dědičnost šablony
• variabilní filtry^[6]
• Podpora i18n (gettext)
• makra
• plně výsuvný^[3][7]

Větvička je podporována následujícími integrovaná vývojová prostředí:^[3]

• Zatmění prostřednictvím pluginu Twig
• Komodo a Komodo Upravit prostřednictvím režimu zvýraznění / syntaxe větvičky
• NetBeans prostřednictvím pluginu Twig syntax (do 7.1, nativní od 7.2)
• Php Storm (nativní od 2.1)

A textoví redaktoři:

• Atom pomocí větvičky PHP pro atom
• emacs přes web-mode.el
• Poznámkový blok ++ prostřednictvím zvýrazňovače větví Notepad ++
• Vznešený text prostřednictvím balíčku Twig
• TextMate prostřednictvím balíčku Twig
• vim prostřednictvím pluginu Jinja syntaxe nebo pluginu vim-twig
• Závorky přes závorky Twig
• Kód Visual Studio prostřednictvím rozšíření Twig
• GTKSourceView prostřednictvím definice jazyka Twig
• Coda prostřednictvím syntaxe režimu Větvička
• Coda 2 prostřednictvím druhého režimu syntaxe Twig
• SubEthaEdit prostřednictvím syntaxe režimu Větvička

Syntax

Větvička definuje tři druhy oddělovačů:

• {{ ... }}, k tisku obsahu proměnných nebo výsledku vyhodnocení výrazu (např .: zděděná šablona Větvička s {{rodič ()}}).
• {# ... #}, pro přidání komentářů do šablon. Tyto komentáře nejsou zahrnuty na vykreslené stránce.
• {% ... %}, provádět příkazy, například for-loops.
  • {% soubor foo = 'bar' %}, přiřadit.^[8]
  • {% -li i je definovaný a i == 1%} ... {% endif %}: stav.
  • {% pro i v 0..10 %} ... {% konec %}: počítadlo ve smyčce.

Apostrop (') je úniková postava.

Vytvoření iteračního pole:

{% soubor myArray = [1, 2] %}

Asociativní pole:

{% soubor myArray = {'klíč': 'hodnota'} %}

Přednost operátorů

Přednost operátorů je,^[3] od méně k větší prioritě:

Filtry

Filtry poskytují některé úpravy výrazu, pokud jsou umístěny za ním, oddělené trubkami. Například:^[6]

• kapitalizovat: změní první písmeno řetězce na velké.
• horní: změní celý řetězec na velká písmena.
• za prvé: zobrazí první řádek pole.
• délka: vrátí proměnnou velikost.

Speciální proměnné

• smyčka obsahuje informace o aktuální smyčce. Například loop.index odpovídá počtu iterací, které již proběhly.
• Globální proměnné začínají podtržítky. Například:
  • _route (část URL umístěná za doménou)
  • _self (aktuální název souboru)

  Takže k trase stránky: {{cesta (app.request.attributes.get ('_ route'), app.request.attributes.get ('_ route_params'))}}

• CGI proměnné prostředí, jako {{app.request.server.get ('SERVER_NAME')}}.

Příklad

Následující příklad ukazuje některé základní vlastnosti Twig.

{% rozšiřuje „base.html“ %}{% blok navigace %}    <ul id="navigace">    {% pro položka v navigace %}        <li>            <A href="{{ item.href }}">                {% -li item.level == 2 %}& nbsp; & nbsp;{% endif %}                {{ item.caption|horní }}            </A>        </li>    {% konec %}    </ul>{% koncový blok navigace %}

Viz také

• Chytrý

Reference

externí odkazy

• Větvička oficiální webové stránky
• Šablony motorů v PHP, Fabien Potencier, 2009