الوسوم في 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 فانظر الدوال في لغات البرمجة العادية إذ هما متقاربتان في الوظيفة، وهذه الشيفرات الجامعة مفيدة في إعادة استخدام أجزاء القالب كي لا نعيد اختراع العجلة ونكرر شيفرات موجودة مسبقًا.
sandbox
يمكن استخدام وسم sandbox لتفعيل وضع صندوق الاختبار لقالب مدرَج إذا كان صندوق الاختبار غير مفعل تفعيلًا عامًا لبيئة Twig.
set
تستطيع إسناد القيم إلى المتغيرات داخل كتل الشيفرات، وتستخدم الإسنادات وسم set ويمكن أن يكون لها أهداف متعددة.
use
تخبر تعليمة use محرك القوالب Twig أن يستورد كتلة معرفة إلى القالب الحالي.
verbatim
يميز الوسم verbatim النص ليكون خامًا لمنع إجراء تحليل parse عليه.
with
استخدم الوسم with لإنشاء نطاق داخلي جديد، ولا تكون المتغيرات المسندة في هذا النطاق مرئية لمن هو خارجه.