導入

完了

Liquid は、Web ページに動的コンテンツを追加するために使用できるオープンソース テンプレート言語です。 Liquid コードは、HTML またはテキスト コンテンツ (Web ページ、コンテンツ スニペット、Web テンプレートのコンテンツなど) を入力できる Microsoft Power Pages 内の任意の場所で使用できます。

Liquid では、コンテンツを作成して、変革を適用し、実装フローを制御するのに役立つさまざまな言語コンストラクトが提供されます。 FetchXML クエリ言語の使用、または識別子によるテーブル行の直接取得によって Microsoft Dataverse データにアクセスするための機能を提供する Liquid は、データ駆動型の Web ページを作成するための第一選択肢となります。 また、多くの特別なタグ (または処理命令) が含まれており、再利用可能な Web テンプレートの作成を特にターゲットとしています。 次のセクションでは、Microsoft Power Pages Web サイトでテンプレートを使用する方法について説明します。

テンプレート

Power Pages では、レンダリングされたページが Web サイトでどのように表示されるかは定義されません。 代わりに、レイアウトと動作を定義するページ テンプレート行にリンクされます。

Power Pages Web サイトで使用できるテンプレートには次の 2 つのタイプがあります。

  • 書き換え - これらのテンプレートでは、サーバー側の処理を使用して、一部のコンポーネントや特別なページ (エラー ページ、サインイン ページなど) で必要となる特殊な動作を実装します。

  • Web テンプレート - リンクされたレイアウト テンプレートは、ページのコンテンツを出力用にどのようにレンダリングするかを定義します。

書き換え テンプレートは、カスタマイズ機能が限定されています。 Liquid テンプレート言語は、コンテンツの一部としてまたはコンテンツ スニペット内で使用できますが、ページ レイアウトと動作は事前に定義されています。

一方、Web テンプレート オプションは完全にテンプレートを基にしており、Liquid を使用して、コンテンツのレンダリング方法を定義します。 テンプレートは柔軟です。 テンプレートには、コンテンツの一部として他のテンプレートを含めることができます。 また、テンプレートは別のテンプレートを基にして、基本機能を拡張することもできます。 Web テンプレートの一番の強みは、Dataverse データへのアクセスなど、静的コンテンツに処理機能を追加するような Liquid コードを持てることにあります。

ヒント

Web テンプレートには、HTML、カスケード スタイル シート (CSS)、JavaScript を含めることもできます。

Web テンプレートを使用すると、Web ページ全体、ページの一部、またはサイト ヘッダーやフッターなどの一般的な要素を定義することができます。 この方法により、Web サイト全体で一貫した外観と動作が生み出され、レンダリングされる外観やデータを簡単に変更できるようになります。 次の例は、一般的な単純なテンプレートを示しています。

<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 データをレンダリングします。

Web テンプレート (Web サイトのヘッダーとフッター)

Web テンプレートを使用すると、Power Pages Web サイトで使用するグローバル ヘッダーおよびグローバル フッターを上書きすることができます。 このタスクを完了するには、Web サイトのヘッダー テンプレートまたはフッター テンプレート列を、選択した Web テンプレートに設定します。

Web テンプレートのヘッダーとフッターのスクリーンショット。

ヘッダー テンプレート列を上書きすると、選択したテンプレートは、通常は既定のヘッダー テンプレートで処理されるサイト インターフェイス要素向けに、プライマリ ナビゲーション、サインイン/サインアウト リンク、検索インターフェイスなどをレンダリングする役割を担います。

ヒント

Web サイト行でヘッダーまたはフッターのテンプレートを指定しなかった場合は、既定のコンテンツがレンダリングされます。 ヘッダーまたはフッターを完全に削除するには、空のテンプレートを指定します。