Twig (движок шаблонов)

Ветка

Оригинальный автор(ы)	Армин Роначер , Фабьен Потенсье
Разработчик(и)	Симфони САС
Первоначальный выпуск	12 октября 2009 г. ( 12.10.2009 )
Стабильная версия	3.10.3 / 16 мая 2024 г ( 16 мая 2024 г. )
Репозиторий	github .с /twigphp /Ветка
Написано в	PHP
Операционная система	Кросс-платформенный
Тип	Шаблонизатор
Лицензия	Лицензия БСД
Веб-сайт	ветка .symfony .с

Twig — это шаблонизатор для языка программирования PHP . Его синтаксис основан на шаблонах Jinja и Django . Это продукт с открытым исходным кодом лицензируется по лицензии BSD и поддерживается Фабьеном Потенсье. Первоначальную версию создал Армин Ронахер . Фреймворк Symfony PHP поставляется с встроенной поддержкой Twig в качестве механизма шаблонов по умолчанию, начиная с версии 2.

Тот же язык шаблонов используется механизмом шаблонов Nunjucks, поэтому Nunjucks также поддерживается следующими инструментами.

Функции

• Сложный поток управления
• Автоматический выход
• Наследование шаблонов
• Переменные фильтры
• поддержка i18n (gettext)
• Макросы
• Полностью расширяемый

Twig поддерживается следующими интегрированными средами разработки :

• Eclipse через плагин Twig
• Komodo и Komodo Edit через режим выделения/проверки синтаксиса Twig
• NetBeans через плагин синтаксиса Twig (до версии 7.1, встроенный с версии 7.2)
• PhpStorm (родной начиная с версии 2.1)
• IntelliJ IDE, включая WebStorm, через плагин

И текстовые редакторы:

• Atom через PHP-ветку для атома
• Emacs через web-mode.el
• Notepad++ через Notepad++ Twig Highlighter
• Sublime Text через пакет Twig
• TextMate через пакет Twig
• Vim через плагин синтаксиса Jinja или плагин vim-twig.
• Скобки через Brackets Twig
• Код Visual Studio через расширение Twig
• GTKSourceView через определение языка Twig
• Coda через синтаксический режим Twig
• Coda 2 через другой синтаксический режим Twig
• SubEthaEdit через синтаксический режим Twig

Синтаксис

Twig определяет три типа разделителей:

• {{ ... }}, чтобы распечатать содержимое переменных или результат вычисления выражения (например: унаследованный шаблон Twig с {{ parent() }}).
• {# ... #}, для добавления комментариев в шаблоны. Эти комментарии не включаются в отображаемую страницу.
• {% ... %}, для выполнения операторов, таких как циклы for.
  • {% set foo = 'bar' %}, назначить.
  • {% if i is defined and i == 1%} ... {% endif %}: состояние.
  • {% for i in 0..10 %} ... {% endfor %}: счетчик в цикле.

Апостроф (') является escape-символом.

Чтобы создать итеративный массив:

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

Ассоциативный массив:

{% set myArray = {'key': 'value'} %}

Приоритет операторов

Приоритет операторов: от меньшего к большему приоритету:

Оператор	Роль
группа	Побитовое И
b-xor	Побитовое исключающее ИЛИ
б-или	Побитовое ИЛИ
или	Или
и	И
==	Равен?
!=	Отличается?
<	Низший
>	Начальство
>=	Высший или равный
<=	Низший или равный
в	В
спички	Соответствует
начинается с	Начинается с
заканчивается	Заканчивается к
..	Последовательность (например: 1..5)
+	Плюс
-	Меньше
~	Конкатенация
*	Умножение
/	Разделение
//	Деление округлено в меньшую сторону
%	Модуль
является	Тест (например: is defined или is not empty)
**	Власть
|	Фильтр
[]	Запись массива
.	Атрибут или метод объекта (например: country.name)

Фильтры

Фильтры обеспечивают некоторую обработку выражения, если они расположены после него и разделены вертикальной чертой. Например:

• capitalize: меняет первую букву строки на заглавную.
• upper: меняет всю строку на заглавную.
• first: отображает первую строку массива.
• length: возвращает переменный размер.

Специальные переменные

• loop содержит информацию о текущем цикле. Например loop.index соответствует количеству уже произошедших итераций.
• Глобальные переменные начинаются с подчеркивания. Например:
  • _route (часть URL, расположенная после домена)
  • _self (текущее имя файла)

  Итак, к маршруту страницы: {{ path(app.request.attributes.get('_route'), app.request.attributes.get('_route_params')) }}

• CGI Переменные среды , такие как {{ app.request.server.get('SERVER_NAME') }}.

Пример

Пример ниже демонстрирует некоторые основные функции Twig.

{% extends "base.html" %}
{% block navigation %}
    <ul id="navigation">
    {% for item in navigation %}
        <li>
            <a href="{{ item.href }}">
                {% if item.level == 2 %}&nbsp;&nbsp;{% endif %}
                {{ item.caption|upper }}
            </a>
        </li>
    {% endfor %}
    </ul>
{% endblock navigation %}

См. также

• Умник

Внешние ссылки

• Официальный сайт Твига
• Фабьен Потенсье (07 октября 2009 г.). «Шаблоны в PHP» . Проверено 27 октября 2023 г.