Twig/use

إعادة الاستخدام هي ميزة متقدمة في Twig ولا تحتاج إليها إلا نادرًا في القوالب العادية، وتستخدمها المشاريع التي تريد للقوالب أن يعاد استخدامها دون الحاجة إلى الوراثة.

تُعد وراثة القوالب من أقوى المزايا التي في محرك القوالب Twig، لكنها محدودة بوراثة واحدة، فالقالب لا يمكنه إلا أن يوسع قالبًا آخر فقط، وهذا القيد يجعل وراثة القوالب سهلة الفهم والتنقيح معًا:

{% extends "base.html" %}

{% block title %}{% endblock %}
{% block content %}{% endblock %}

وإعادة الاستخدام الأفقية هي طريقة لتحقيق نفس هدف الوراثة المتعددة، لكن من غير التعقيد الذي قد يأتي معها:

{% extends "base.html" %}

{% use "blocks.html" %}

{% block title %}{% endblock %}
{% block content %}{% endblock %}

تخبر تعليمة use محرك القوالب Twig أن يستورد الكتل المعرفة في blocks.html إلى القالب الحالي، وقد يكون هذا قريبًا من سلوك الشيفرات الجامعة، لكنه لكتل الشيفرات هنا:

{# blocks.html #}

{% block sidebar %}{% endblock %}

تستورد تعليمة use في المثال السابق كتلة sidebar إلى القالب الأساسي، وتكون الشيفرة مكافئة للشيفرة التالية أدناه (لا تُخرَج الكتل المستوردة تلقائيًا):

{% extends "base.html" %}

{% block sidebar %}{% endblock %}
{% block title %}{% endblock %}
{% block content %}{% endblock %}

لاحظ أن وسم use يستورد القالب فقط إذا لم يوسع قوالب أخرى ولم يعرِّف شيفرات جامعة (macro) وكان المتن (body) فارغًا، لكنه يستطيع استخدام القوالب الأخرى. كذلك لا يمكن أن يكون مرجع القالب تعبيرًا لأن تعليمات use تٌحل حلًا مستقلًا عن السياق الممرر إلى القالب. يستطيع القالب الأساسي أن يتخطى أي كتلة مستوردة، فإذا كان القالب قد عرّف كتلة sidebar فيتم تجاهل الكتلة المعرفة في blocks.html، ويمكنك إعادة تسمية الكتل المستوردة لئلا يقع خلط وتعارض بين الأسماء:

{% extends "base.html" %}

{% use "blocks.html" with sidebar as base_sidebar, title as base_title %}

{% block sidebar %}{% endblock %}
{% block title %}{% endblock %}
{% block content %}{% endblock %}

تحدد الدالة parent()‎ شجرة الوراثة الصحيحة تلقائيًا كي تُستخدم عند تخطي كتلة معرفة في قالب مستورد:

{% extends "base.html" %}

{% use "blocks.html" %}

{% block sidebar %}
    {{ parent() }}
{% endblock %}

{% block title %}{% endblock %}
{% block content %}{% endblock %}

في المثال السابق، ستستدعي دالة parent()‎ كتلة sidebar من القالب blocks.html. تسمح لك إعادة التسمية بمحاكاة الوراثة من خلال استدعاء الكتلة الأب:

{% extends "base.html" %}

{% use "blocks.html" with sidebar as parent_sidebar %}

{% block sidebar %}
    {{ block('parent_sidebar') }}
{% endblock %}

لاحظ أنه لا حد لعدد تعليمات use التي يمكن استخدامها في أي قالب، وإذا عرّف قالبان مستوردان نفس الكتلة فإن الأخير هو الذي يحوزها.

انظر أيضًا

• مقدمة عن محرك القوالب Twig.
• توسيع Twig.

المصادر

• صفحة الوسم use من توثيق Twig الرسمي.