الفرق بين المراجعتين ل"Twig/tags"
جميل-بيلوني (نقاش | مساهمات) ط |
جميل-بيلوني (نقاش | مساهمات) |
||
| سطر 1: | سطر 1: | ||
<noinclude>{{DISPLAYTITLE: الوسوم في Twig}}</noinclude> | <noinclude>{{DISPLAYTITLE: الوسوم في Twig}}</noinclude> | ||
الوسوم هي بنيات تحكم، تتحكم في طريقة عمل القوالب وسيرها، وهي تتكون من شرطيات (مثل if/elseif/else) وحلقات تكرارية وكُتل. وتظهر الوسوم داخل أزواج من كُتل <code>{% %}</code>، وتكون كتلة الإغلاق <code>{% %}</code> هي end متبوعة باسم الوسم. وفيما يلي الوسوم الموجودة في محرك القوالب Twig: | الوسوم هي بنيات تحكم، تتحكم في طريقة عمل القوالب وسيرها، وهي تتكون من شرطيات (مثل 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 Tags]] | [[تصنيف:Twig Tags]] | ||
مراجعة 18:39، 5 مايو 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 لإنشاء نطاق داخلي جديد، ولا تكون المتغيرات المسندة في هذا النطاق مرئية لمن هو خارجه.