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