الفرق بين المراجعتين لصفحة: «Twig/coding standards»

من موسوعة حسوب
ط مراجعة
طلا ملخص تعديل
 
سطر 2: سطر 2:
إن{{DISPLAYTITLE:معايير كتابة الشيفرة في Twig}}نا ننصح أثناء كتابة قوالب Twig باتباع معايير الكتابة التالية:
إن{{DISPLAYTITLE:معايير كتابة الشيفرة في Twig}}نا ننصح أثناء كتابة قوالب Twig باتباع معايير الكتابة التالية:


* ضع{{DISPLAYTITLE:معايير كتابة الشيفرة في Twig}} مسافة واحدة -واحدة فقط- بعد بدء المحدِّد (delimiter) <code><nowiki>}}</nowiki></code> و ‎‏<code>%}‎</code> و ‎<code>{#‎</code>، وقبل نهاية المحدِّدات <code><nowiki>{{</nowiki></code> و <code>{%</code> و <code>{#</code>:
* ضع{{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>-</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>not</code>, <code>and</code>, <code>or</code>، و <code>~</code> و <code>is</code> و <code>in</code>
** العامل الثلاثي (‎<code>?:‎</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 %}

انظر أيضًا

المصادر