معايير كتابة الشيفرة في Twig

إننا ننصح أثناء كتابة قوالب Twig باتباع معايير الكتابة التالية:

ضع مسافة واحدة -واحدة فقط- بعد بدء المحدِّد (delimiter) }} و ‎‏%}‎ و ‎{#‎، وقبل نهاية المحدِّدات {{ و {% و {#:

{{ foo }}
{# تعليق #}
{% if foo %}{% endif %}

وعند استخدام محرف التحكم في المسافات الفارغة، لا تضع أي مسافات بينه وبين المحدِّد:

{{- foo -}}
{#- تعليق -#}
{%- if foo -%}{%- endif -%}

ضع مسافة واحدة -واحدة فقط- قبل وبعد العوامل التالية:
- عوامل الموازنة (==, ‎!=‎, <, >, ‎>=‎, ‎<=‎).
- العوامل الرياضية (+, -, /, *, %, //, **).
- العوامل المنطقية (not, and, or)، و ~ و is و in.
- العامل الثلاثي (‎?:‎):

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

ضع مسافة واحدة -واحدة فقط- بعد علامة : في الجداول (hashes) و , في المصفوفات والجداول:

{{ [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 %}

انظر أيضًا