埋め込み文法の基本

埋め込み文法には大まかに2種類存在します。

  • コンテンツのリストをサイトに埋め込む
  • 1つのコンテンツをサイトに埋め込む

コンテンツのリストをサイトに埋め込む

Spear は全ページから cms-loop 属性を検索します。もし Spear が cms-loop を見つけたら、データリソースからデータをフェッチします。

この場合、以下の属性も指定する必要があります。

属性属性値の型必須 or オプション説明
cms-loopN/A (No value)N/Aこれはコンテンツリストを表示するかどうかのフラグです。
cms-content-typestringrequiredコンテンツタイプ名を指定します。

ループ要素

Spear は cms-loop 属性を持つ要素内のすべてを繰り返し生成します。

例えば、以下の HTML コードの場合、コンテンツの数だけ要素の生成を繰り返します。

  • /src/index.html
...
<body>
  <ul>
    <li cms-loop cms-content-type="news">
      <h1>{%= blog_title %}</h1>
    </li>
  </ul>
</body>
  • generated html(/dist/index.html)
...
<body>
  <ul>
    <li>
      <h1>2021/10/10</h1>
    </li>
    <li>
      <h1>2021/10/11</h1>
    </li>
    <li>
      <h1>2021/10/12</h1>
    </li>
  </ul>
</body>

1つのコンテンツをサイトへ埋め込む

このドキュメントは公開予定です。