الوسوم في Twig

الوسوم هي بنيات تحكم، تتحكم في طريقة عمل القوالب وسيرها، وهي تتكون من شرطيات (مثل 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 فانظر الدوال في لغات البرمجة العادية إذ هما متقاربتان في الوظيفة، وهذه الشيفرات الجامعة مفيدة في إعادة استخدام أجزاء القالب كي لا نعيد اختراع العجلة ونكرر شيفرات موجودة مسبقًا.