マニュアル » MEタグリファレンス » リピート タグ (repeat)

リピートタグ (repeat)

概要

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

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

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

フォーマット<!--{repeat id="id_name"}--><!--{/repeat}-->
包含可能MEタグ テキスト
テキストエリア
リッチテキスト
日付
画像
ソース
属性
削除
ディスプレイ

属性

IDMEタグ識別子。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"}-->商品1<!--{/text}--></li><!--{/repeat}-->
</ul>

備考

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

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

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