リピートタグ (repeat)
概要
MEタグをグループ化して、繰り返し利用するためのMEタグ。
ページ編集画面では、グループ化したMEタグを追加したり削除したりして管理します。
公開サイト側では、登録された繰り返しの数だけグループ化したMEタグを出力します。
| フォーマット | 〜 |
|---|---|
| 包含可能MEタグ |
テキスト テキストエリア リッチテキスト 日付 画像 ソース 属性 削除 ディスプレイ |
属性
| ID | MEタグ識別子。MEタグを識別するためのID名です。一つのテンプレート内で同じIDを複数指定することはできません。つまり一意である必要があります。 入力値が空のままだと自動でIDが割り当てられます。 IDは先頭の一文字を英字にして、英字、数字、ハイフン( - )、アンダースコア( _ )のみで入力してください。 |
|---|---|
| ref_id | 参照するMEタグのIDを指定します。 ref_page_idの指定が無い場合は、同じページ内のリピートタグを参照します。 ref_page_idの指定がある場合は、指定されたページ内のリピートタグを参照します。 |
| ref_page_id | 別ページのMEタグを参照する場合に指定します。この属性を指定した場合は、ref_idも指定する必要があります。 |
| ref_template_id | 別テンプレートを元にしたページのMEタグを参照する場合に指定します。 複数IDをカンマ区切りで指定することも可能です。 |
| limit | リピート回数制限値を指定します。 ページ編集画面ではこの制限値は適用されません。プレビューもしくはページ書き出し時にこの項目で指定した数のみ書き出されます。 |
| offset | 参照時のリピート開始位置を指定します。 例えばこの値に "1" を指定すると、最上位のリピート領域は表示せずに2つ目のリピート領域以降を表示します。 |
| sort_by | ref_template_idで参照した情報の並び替え対象を指定します。 参照先のページの「作成日時」(_create_date)または「更新日時」(_update_date)を指定できます。「指定なし」を選択した場合は、「作成日時」と同じ挙動になります。 この属性は、ref_id及びref_page_idを指定した場合には影響しません。 |
| sort_order | ref_template_idで参照した情報の並び替え順を指定します。 「降順」(desc：新しい日付順)または「昇順」(asc：古い日付順)を指定できます。「指定なし」を選択した場合は、「降順」と同じ挙動になります。 この属性は、ref_id及びref_page_idを指定した場合には影響しません。 |
使用例
<ul> <li>商品１</li> </ul>
備考
offsetプロパティは、バージョン 1.0.1 から追加されました。
limit及びoffsetプロパティは、バージョン 1.1.2 未満ではテンプレート参照時のみ有効でした。バージョン 1.1.2 以降ではテンプレート参照以外のケースでも、その設定値が反映されるようになりました。