Стандарты кодирования

При написании шаблонов Twig мы рекомендуем придерживаться следующих официальных стандартов кодирования:

• Поставьте один (и только один) пробел после начала разделителя ({{, {%, и {#) и перед концом разделителя (}}, %}, и #}):

  {{ foo }}
  {# comment #}
  {% if foo %}{% endif %}
  

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

  {{- foo -}}
  {#- comment -#}
  {%- if foo -%}{%- endif -%}
  

• Поставьте один (и только один) пробел перед и после следующих операторов: операторы сравнения (==, !=, <, >, >=, <=), математические операторы (+, -, /, *, %, //, **), логические операторы (not, and, or), ~, is, in, и условный оператор (?:):

  {{ 1 + 2 }}
  {{ foo ~ bar }}
  {{ true ? true : false }}
  

• Поставьте один (и только один) пробел после знака : в хешах и , в массивах и хешах:

  {{ [1, 2, 3] }}
  {{ {'foo': 'bar'} }}
  

• Не ставьте пробелы после открывающей скобки и перед закрывающей скобкой в выражениях:

  {{ 1 + (2 * 3) }}
  

• Не ставьте пробелы перед и после разделителей строк:

  {{ 'foo' }}
  {{ "foo" }}
  

• Не ставьте пробелы перед и после следующих операторов: |, ., .., []:

  {{ foo|upper|lower }}
  {{ user.name }}
  {{ user[name] }}
  {% for i in 1..12 %}{% endfor %}
  

• Не ставьте пробелы перед и после скобок, используемых для вызовов фильтров и функций:

  {{ foo|default('foo') }}
  {{ range(1..10) }}
  

• Не ставьте пробелы перед и после открытия и закрытия массивов и хешей:

  {{ [1, 2, 3] }}
  {{ {'foo': 'bar'} }}
  

• Используйте переменные с нижним регистром и подчеркиваниями:

  {% set foo = 'foo' %}
  {% set foo_bar = 'foo' %}
  

• Отступайте код внутри тегов (используйте тот же отступ, что и для целевого языка сгенерированного шаблона):

  {% block foo %}
  {% if true %}
          true
  {% endif %}
  {% endblock %}