الفرق بين المراجعتين ل"Twig/tags"
جميل-بيلوني (نقاش | مساهمات) ط |
جميل-بيلوني (نقاش | مساهمات) ط |
||
| سطر 9: | سطر 9: | ||
== [[ Twig/block|block]] == | == [[ Twig/block|block]] == | ||
| − | تُستخدم الكُتل | + | تُستخدم الكُتل Blocks من أجل الوراثة أو الاكتساب Inheritance وتتصرف كعناصر نائبة placeholders وبدائل في نفس الوقت. |
== [[ Twig/cache|cache]] == | == [[ Twig/cache|cache]] == | ||
| سطر 21: | سطر 21: | ||
== [[ Twig/embed|embed]] == | == [[ Twig/embed|embed]] == | ||
| − | يجمع وسم <code>embed</code> سلوك كل من الوسمين [[Twig/include|<code>include</code>]] و <code>[[Twig/extends|extends]]</code>، إذ يسمح لك بإدراج محتويات قالب آخر كما يفعل <code>[[Twig/include|include]]</code>، كذلك يسمح لك بتخطي أي كتلة معرفة داخل القالب المدرَج كما يحدث عند توسيع قالب ما، ويمكن النظر إلى القالب المضمَّن على أنه هيكل واجهة مصغر | + | يجمع وسم <code>embed</code> سلوك كل من الوسمين [[Twig/include|<code>include</code>]] و <code>[[Twig/extends|extends]]</code>، إذ يسمح لك بإدراج محتويات قالب آخر كما يفعل <code>[[Twig/include|include]]</code>، كذلك يسمح لك بتخطي أي كتلة معرفة داخل القالب المدرَج كما يحدث عند توسيع قالب ما، ويمكن النظر إلى القالب المضمَّن على أنه هيكل واجهة مصغر micro layout skeleton. |
== [[ Twig/extends|extends]] == | == [[ Twig/extends|extends]] == | ||
| سطر 33: | سطر 33: | ||
== [[ Twig/from|from]] == | == [[ Twig/from|from]] == | ||
| − | يستورد الوسم <code>from</code> أسماء وسوم الشيفرات الجامعة | + | يستورد الوسم <code>from</code> أسماء وسوم الشيفرات الجامعة <code>[[Twig/macro|macro]]</code> إلى فضاء الاسم الحالي. |
== [[ Twig/if|if]] == | == [[ Twig/if|if]] == | ||
| سطر 39: | سطر 39: | ||
== [[ Twig/import|import]] == | == [[ Twig/import|import]] == | ||
| − | يستورد الوسم <code>import</code> أسماء الشيفرات الجامعة | + | يستورد الوسم <code>import</code> أسماء الشيفرات الجامعة macros إلى متغير محلي. |
== [[ Twig/include|include]] == | == [[ Twig/include|include]] == | ||
| − | تتضمن تعليمة <code>include</code> قالبًا وتخرِج المحتوى المصيَّر | + | تتضمن تعليمة <code>include</code> قالبًا وتخرِج المحتوى المصيَّر rendered لذلك الملف. |
== [[ Twig/macro|macro]] == | == [[ Twig/macro|macro]] == | ||
| − | إذا أردت فهم طبيعة الشيفرات الجامعة | + | إذا أردت فهم طبيعة الشيفرات الجامعة macros في محرك القوالب Twig فانظر الدوال في لغات البرمجة العادية إذ هما متقاربتان في الوظيفة، وهذه الشيفرات الجامعة مفيدة في إعادة استخدام أجزاء القالب كي لا نعيد اختراع العجلة ونكرر شيفرات موجودة مسبقًا. |
== [[ Twig/sandbox|sandbox]] == | == [[ Twig/sandbox|sandbox]] == | ||
| سطر 57: | سطر 57: | ||
== [[ Twig/verbatim|verbatim]] == | == [[ Twig/verbatim|verbatim]] == | ||
| − | يميز الوسم <code>verbatim</code> النص ليكون خامًا لمنع إجراء تحليل | + | يميز الوسم <code>verbatim</code> النص ليكون خامًا لمنع إجراء تحليل parse عليه. |
== [[ Twig/with|with]] == | == [[ Twig/with|with]] == | ||
مراجعة 06:04، 11 مايو 2021
الوسوم هي بنيات تحكم، تتحكم في طريقة عمل القوالب وسيرها، وهي تتكون من شرطيات (مثل if/elseif/else) وحلقات تكرارية وكُتل. وتظهر الوسوم داخل أزواج من كُتل {% %}، وتكون كتلة الإغلاق {% %} هي end متبوعة باسم الوسم. وفيما يلي الوسوم الموجودة في محرك القوالب Twig.
apply
يسمح لك الوسم apply بتطبيق مرشحات Twig على كتلة من بيانات القالب.
autoescape
تستطيع تحديد جزء من قالب ما من أجل التحكم في تهريبه باستخدام الوسم autoescape.
block
تُستخدم الكُتل Blocks من أجل الوراثة أو الاكتساب Inheritance وتتصرف كعناصر نائبة placeholders وبدائل في نفس الوقت.
cache
الوسم cache يخبر Twig أن يخزن جزءًا من القالب تخزينًا مؤقتًا.
deprecated
يولِّد محرك القوالب Twig إشعار إهمال من خلال استدعاء إلى دالة PHP هي trigger_error() حيث يُستخدم الوسم deprecated في القالب.
do
يشبه أسلوب عمل وسم do أسلوبَ العمل للتعبير المتغير العادي {{ ... }} غير أنه لا يطبع شيئًا.
embed
يجمع وسم embed سلوك كل من الوسمين include و extends، إذ يسمح لك بإدراج محتويات قالب آخر كما يفعل include، كذلك يسمح لك بتخطي أي كتلة معرفة داخل القالب المدرَج كما يحدث عند توسيع قالب ما، ويمكن النظر إلى القالب المضمَّن على أنه هيكل واجهة مصغر micro layout skeleton.
extends
يُستخدم الوسم extends مع قالب ليرث من قالب آخر.
flush
الوسم flush يخبر Twig أن يفرغ المخزون المؤقت للخرج.
for
يكرر وسم for على كل عنصر من عناصر تسلسل ما.
from
يستورد الوسم from أسماء وسوم الشيفرات الجامعة macro إلى فضاء الاسم الحالي.
if
يمكن استخدامها في أبسط صورة لها كشرط مع تعبير ما لننظر هل يقيَّم إلى true أم false.
import
يستورد الوسم import أسماء الشيفرات الجامعة macros إلى متغير محلي.
include
تتضمن تعليمة include قالبًا وتخرِج المحتوى المصيَّر rendered لذلك الملف.
macro
إذا أردت فهم طبيعة الشيفرات الجامعة macros في محرك القوالب Twig فانظر الدوال في لغات البرمجة العادية إذ هما متقاربتان في الوظيفة، وهذه الشيفرات الجامعة مفيدة في إعادة استخدام أجزاء القالب كي لا نعيد اختراع العجلة ونكرر شيفرات موجودة مسبقًا.
sandbox
يمكن استخدام وسم sandbox لتفعيل وضع صندوق الاختبار لقالب مدرَج إذا كان صندوق الاختبار غير مفعل تفعيلًا عامًا لبيئة Twig.
set
تستطيع إسناد القيم إلى المتغيرات داخل كتل الشيفرات، وتستخدم الإسنادات وسم set ويمكن أن يكون لها أهداف متعددة.
use
تخبر تعليمة use محرك القوالب Twig أن يستورد كتلة معرفة إلى القالب الحالي.
verbatim
يميز الوسم verbatim النص ليكون خامًا لمنع إجراء تحليل parse عليه.
with
استخدم الوسم with لإنشاء نطاق داخلي جديد، ولا تكون المتغيرات المسندة في هذا النطاق مرئية لمن هو خارجه.