عرض مصدر Twig/include function

<noinclude>{{DISPLAYTITLE: الدالة include في Twig}}</noinclude>
تعيد الدالة <code>include</code> المحتوى المُخرَج لقالب ما:<syntaxhighlight lang="twig">
{{ include('template.html') }}
{{ include(some_var) }}
</syntaxhighlight>يكون للقوالب المدرَجة وصول إلى متغيرات السياق النشط، وإذا كنت تستخدم محمِّل نظام الملفات فيُبحث حينها عن القوالب في المسارات المعرفة به. كذلك يُمرَّر السياق افتراضيًا إلى القالب لكن يمكن تمرير متغيرات إضافية. انظر المثال أدناه حيث يكون لـ <code>template.html</code> وصول إلى المتغيرات التي في السياق الحالي والمتغيرات الإضافية التي تم توفيرها:<syntaxhighlight lang="twig">
{{ include('template.html', {foo: 'bar'}) }}
</syntaxhighlight>يمكن تعطيل الوصول إلى السياق بضبط <code>with_context</code> على <code>false</code>، انظر المثال التالي حيث لا يُسمح بالوصول إلا إلى المتغير <code>foo</code>:<syntaxhighlight lang="twig">
{{ include('template.html', {foo: 'bar'}, with_context = false) }}
</syntaxhighlight>وهنا لا يُسمح بالوصول إلى أي متغير:<syntaxhighlight lang="twig">
{{ include('template.html', with_context = false) }}
</syntaxhighlight>إذا كان التعبير يقيَّم إلى نسخة  ‎<code>\Twig\Template</code> أو  ‎<code>\Twig\TemplateWrapper</code> فإن Twig يستخدمه مباشرة:<syntaxhighlight lang="twig">
// {{ include(template) }}

$template = $twig->load('some_template.twig');

$twig->display('template.twig', ['template' => $template]);
</syntaxhighlight>عند تعيين راية <code>ignore_missing</code> فإن Twig يعيد سلسلة نصية فارغة إذا لم يكن القالب موجودًا:<syntaxhighlight lang="twig">
{{ include('sidebar.html', ignore_missing = true) }}
</syntaxhighlight>يمكن توفير قائمة من القوالب التي يُتحقق من وجودها قبل الإدراج، ويُخرَج أول قالب موجود:<syntaxhighlight lang="twig">
{{ include(['page_detailed.html', 'page.html']) }}
</syntaxhighlight>إذا تم تعيين <code>ignore_missing</code> فإنه لا يخرِج شيئًا إذا لم يكن أي من القوالب موجودًا، وإلا فإنه يرفع اعتراضًا (exception). إذا أنشأ المستخدم النهائي القالب فيجب وضعه في صندوق اختبار (sand box) قبل إدراجه:<syntaxhighlight lang="twig">
{{ include('page.html', sandboxed = true) }}
</syntaxhighlight>

== الوسائط ==

* <code>template</code>: القالب الذي يجب إخراجه.
* <code>variables</code>: القوالب التي يجب تمريرها إلى القالب.
* <code>with_context</code>: تمرير متغيرات السياق الحالي أم لا.
* <code>ignore_missing</code>: تجاهل القوالب المفقودة أم لا.
* <code>sandboxed</code>: وضع القالب في صندوق اختبار أم لا.

== انظر أيضًا ==
* [[Twig/intro|مقدمة عن محرك القوالب Twig.]]
* [[Twig/advanced|توسيع Twig.]]
* [[Twig/internals|المكونات الداخلية لـ Twig.]]
* [[Twig/tags|الوسوم في Twig]].
* [[ Twig/filters|المرشحات في Twig]].
* [[ Twig/functions|الدوال في Twig]].
== المصادر ==
* [https://twig.symfony.com/doc/3.x/functions/include.html صفحة توثيق الدالة include في توثيق Twig الرسمي].

[[تصنيف:Twig]]
[[تصنيف:Twig Functions]]