Twig 中文文档
  • 关于
  • Twig 1.x
  • Twig 2.x
    • 介绍
    • 安装
    • Twig for 模板设计师
    • Twig for 开发者
    • 扩展 Twig
    • Twig 内部机制
    • 弃用功能
    • Twig 方法
    • 编码标准
    • API
    • 附录*核心扩展
      • 标签(Tags)
        • 自动转义 autoescape
        • 块 block
        • do
        • embed
        • extends
        • filter
        • flush
        • for
        • from
        • if
        • import
        • include
        • macro
        • sandbox
        • set
        • spaceless
        • use
        • verbatim
        • with
      • 过滤器(Filters)
        • abs
        • batch
        • capitalize
        • convert_encoding
        • date
        • date_modify
        • default
        • escape
        • first
        • format
        • join
        • json_encode
        • keys
        • last
        • length
        • lower
        • merge
        • nl2br
        • number_format
        • raw
        • replace
        • reverse
        • round
        • slice
        • sort
        • split
        • striptags
        • title
        • trim
        • upper
        • url_encode
      • 函数(Functions)
        • attribute
        • block
        • constant
        • cycle
        • date
        • dump
        • include
        • max
        • min
        • parent
        • random
        • range
        • source
        • template_from_string
      • 测试(Tests)
        • constant
        • defined
        • divisible by
        • empty
        • even
        • iterable
        • null
        • odd
        • same as
      • Operators(操作符)
  • 附录*资料整理
Powered by GitBook
On this page

Was this helpful?

  1. Twig 2.x

编码标准

PreviousTwig 方法Next附录*核心扩展

Last updated 6 years ago

Was this helpful?

原文: 翻译:小虾米(QQ:509129)

编码标准

在编写Twig模板时,我们建议您遵循以下官方编码标准:

  • 在分隔符({、{ %和{ #)的开头和分隔符(}、% }和# }结束之前)放置一个(和仅一个)空格。

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

当使用空格控制字符时,不要在它和分隔符之间放置空格:

{{- foo -}}
{#- comment -#}
{%- if foo -%}{%- endif -%}
  • 在下列操作符前后放置一个(并且只有一个)空格:比较运算符(= =,!=、<、>、> =、< =)、数学操作符(+、-、/、* %,/ / * *),逻辑运算符(,,),~,,,和三元操作符(?):

{{ 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 %}
Coding Standards