السابق

التالي

مقدمة

مكتمل

إن Liquid هي لغة قالب مصدر مفتوح يمكنك استخدامها لإضافة محتوى ديناميكي إلى صفحات الويب. يمكنك استخدام رمز Liquid فِي أي مكان فِي Microsoft Power Pages التي يمكنك فيها إدخال محتوى HTML أو محتوى نصي، بما فِي ذلك المحتوى فِي صفحات ويب وأجزاء التعليمات البرمجية المتكررة للمحتوى وقوالب الويب.

يوفر Liquid ثوابت لغة مختلفة تساعد فِي إنشاء المحتوى، وتطبيق التحويلات، والتحكم فِي تدفق التنفيذ. القدرة على الوصول إلى بيانات Microsoft Dataverse باستخدام لغة استعلام FetchXML أو استرداد صفوف الجدول مباشرة عن طريق المعرّفات تجعل Liquid الخيار الأساسي لبناء صفحات ويب تعتمد على البيانات. ويتضمن أيضاً العديد من العلامات الخاصة (أو إرشادات المعالجة) التي تستهدف بشكل محدّد إنشاء قوالب ويب القابلة لإعادة الاستخدام. توضح الأقسام التالية كيف يمكنك استخدام القوالب فِي مواقع ويب Microsoft Power Pages.

القوالب

في Power Pages، لا يحدّد صف صفحة الويب كيف تبدو الصفحة المعروضة على موقع الويب. يتم ربطه بدلاً من ذلك بـ قالب صفحة يحدّد التخطيط والسلوك.

نوعا القوالب اللذان يُمكن استخدامهما فِي مواقع ويب Power Pages هما:

• إعادة الكتابة - تستخدم هذه القوالب المعالجة من جانب الخادم لتنفيذ السلوك المتخصص الذي تتطلبه بعض المكونات والصفحات الخاصة مثل صفحة الخطأ وتسجيل الدخول وغيرها.

• قالب الويب - يحدّد قالب التخطيط المُرتبط كيفية عرض محتوى الصفحة للإخراج.

توفر قوالب إعادة الكتابة تخصيصات محدودة. يمكنك استخدام لغة قالب Liquid كجزء من المحتوى أو فِي أجزاء التعليمات البرمجية المتكررة للمحتوى، ولكن يتم تعريف السلوك وتخطيط الصفحات مسبقاً.

على العكس، يكون خيار قالب ويب مستنداً إلى القالب بالكامل ويستخدم Liquid لتعريف كيفية تقديم المحتوى. القوالب مرنة. يُمكن لقالب تضمين قوالب أُخرى لأجزاء من المحتوى. يمكن أن يستند القالب أيضاً إلى قالب آخر، مع توسيع الوظيفة الأساسية. وتأتي القدرة الفعلية لقوالب الويب من القدرة على الاحتواء على كود Liquid الذي يضيف قدرات المعالجة إلى المحتوى الثابت، بما فِي ذلك الوصول إلى بيانات Dataverse.

تلميح

يمكن أن تحتوي قوالب ويب على HTML وأوراق الأنماط المتتالية (CSS) وJavaScript.

يُمكنك استخدام قوالب الويب من أجل تحديد صفحة ويب كاملة، أو جزء من صفحة، أو عناصر مُشتركة مثل رأس الصفحة وتذييلها. يُنشئ هذا الأسلوب مظهراً وسلوكاً متسقاً عبر موقع الويب، ويُساعدك فِي تسهيل تعديل المظهر والبيانات المعروضة. يوضح المثال التالي الشكل، الذي قد يبدو عليه القالب البسيط النمطي:

<div class="container">
  <div class="page-heading">
    {% include 'Breadcrumbs' %}
    {% include 'Page Header' %}
  </div>
  <div class="row">
    <div class="col-md-12">
    {% block main %}
      {% include 'Page Copy' %}

      {% if page.adx_entitylist %}
        {% include 'entity_list' key:page.adx_entitylist.id %}
      {% endif %}
    
      {% if page.adx_entityform %}
        {% entityform id: page.adx_entityform.id %}
      {% endif %}

		{% endblock %}
    </div>
  </div>
</div>

يتضمن هذا القالب البسيط قوالب أخرى لتقديم وحدات البت والأجزاء الشائعة. إنه يحدّد كتلة المحتوى التي يمكن عرضها بشكل مختلف بواسطة قالب مشتق، كما يعرض بيانات Dataverse باستخدام صفي القائمة والنموذج ذوي الصلة.

قوالب ويب كرؤوس وتذييلات موقع ويب

يمكنك استخدام قوالب الويب لتجاوز الرأس والتذييل العموميين اللذين يستخدمهما موقع ويب Power Pages. لإنجاز هذه المهمة، قم بتعيين عمود قالب الرأس أو قالب التذييل فِي موقع الويب الخاص بك على قالب الويب الذي تختاره.

إذا تجاوزت عمود قالب الرأس، فإن القالب الذي تم تحديده يفترض المسؤولية عن عرض التنقل الأساسي، وارتباطات تسجيل الدخول/تسجيل الدخول، وواجهة البحث، وما إلى ذلك، لعناصر واجهة الموقع التي تتم معالجتها بشكل عادي بواسطة قالب رأس الصفحة الافتراضي.

تلميح

إذا لم تحدّد قالب رأس أو تذييل فِي صف موقع الويب، فسيتم تقديم المحتوى الافتراضي. لإزالة رأس أو تذييل بالكامل، حدّد قالباً فارغاً.

متابعة