الفرق بين المراجعتين ل"Twig/coding standards"
< Twig
اذهب إلى التنقل
اذهب إلى البحث
جميل-بيلوني (نقاش | مساهمات) ط (مراجعة) |
جميل-بيلوني (نقاش | مساهمات) ط |
||
سطر 2: | سطر 2: | ||
إن{{DISPLAYTITLE:معايير كتابة الشيفرة في Twig}}نا ننصح أثناء كتابة قوالب Twig باتباع معايير الكتابة التالية: | إن{{DISPLAYTITLE:معايير كتابة الشيفرة في Twig}}نا ننصح أثناء كتابة قوالب Twig باتباع معايير الكتابة التالية: | ||
− | * ضع{{DISPLAYTITLE:معايير كتابة الشيفرة في Twig}} مسافة واحدة -واحدة فقط- بعد بدء المحدِّد | + | * ضع{{DISPLAYTITLE:معايير كتابة الشيفرة في Twig}} مسافة واحدة -واحدة فقط- بعد بدء المحدِّد delimiter <code><nowiki>}}</nowiki></code> و <code>%}</code> و <code>{#</code>، وقبل نهاية المحدِّدات <code><nowiki>{{</nowiki></code> و <code>{%</code> و <code>{#</code>: |
<syntaxhighlight lang="twig"> | <syntaxhighlight lang="twig"> | ||
{{ foo }} | {{ foo }} | ||
سطر 14: | سطر 14: | ||
* ضع مسافة واحدة -واحدة فقط- قبل وبعد العوامل التالية: | * ضع مسافة واحدة -واحدة فقط- قبل وبعد العوامل التالية: | ||
− | ** عوامل الموازنة | + | ** عوامل الموازنة <code>==</code>, <code>!=</code>, <code><</code>, <code>></code>, <code>>=</code>, <code><=</code> |
− | ** العوامل الرياضية | + | ** العوامل الرياضية <code>+</code>, <code>-</code>, <code>/</code>, <code>*</code>, <code>%</code>, <code>//</code>, <code>**</code> |
− | ** العوامل المنطقية | + | ** العوامل المنطقية <code>not</code>, <code>and</code>, <code>or</code>، و <code>~</code> و <code>is</code> و <code>in</code> |
− | ** العامل الثلاثي | + | ** العامل الثلاثي <code>?:</code> |
<syntaxhighlight lang="twig"> | <syntaxhighlight lang="twig"> | ||
{{ 1 + 2 }} | {{ 1 + 2 }} |
المراجعة الحالية بتاريخ 06:03، 11 مايو 2021
إننا ننصح أثناء كتابة قوالب 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 %}