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 より、ページ編集画面のリピートタブでリピート領域の「複製」と「以前」「以後」の一括削除ができるようになりました。