リピートタグ (repeat)

概要

MEタグをグループ化して、繰り返し利用するためのMEタグ。

ページ編集画面では、グループ化したMEタグを追加したり削除したりして管理します。

公開サイト側では、登録された繰り返しの数だけグループ化したMEタグを出力します。

フォーマット	<!--{repeat id="id_name"}-->〜<!--{/repeat}-->
包含可能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	並び替え対象とするMEタグのIDを指定します。 ref_template_idを指定した場合は、参照先のページの「作成日時」(_create_date)または「更新日時」(_update_date)を指定できます。「指定なし」を選択した場合は、「作成日時」と同じ挙動になります。 ※1.3.1から任意のMEタグのIDを指定できるようになりました。
sort_order	並び替え順を指定します。「降順」(desc：新しい日付順)または「昇順」(asc：古い日付順)を指定できます。「指定なし」を選択した場合は、「降順」と同じ挙動になります。
equal	表示絞り込むための設定をします。リピートタグ内のMEタグが指定した値と一致するものだけを表示できます。例えば、リピートタグ内にスイッチタグがあり、カテゴリ名を選択している場合、指定したカテゴリだけを表示することが可能です。次のように、絞り込み対象のMEタグIDと一致させた値をコロン記号で繋いで指定します。 info_cate:広報

使用例

<ul>
<!--{repeat id="r1"}--><li><!--{text id="me1"}-->商品１<!--{/text}--></li><!--{/repeat}-->
</ul>

備考

offset 属性は、バージョン 1.0.1 から追加されました。

limit及びoffset属性は、バージョン 1.1.2 未満ではテンプレート参照時のみ有効でした。バージョン 1.1.2 以降ではテンプレート参照以外のケースでも、その設定値が反映されるようになりました。

バージョン 1.3.5 より、ページ編集画面のリピートタブでリピート領域の「複製」と「以前」「以後」の一括削除ができるようになりました。