TreeOrder

ブロックタグ

mt:TreeOrder をはじめ、祖先・子孫・子・親・兄弟をたどるブロックタグの一覧と使い方です。

ブロックタグは、開始タグと終了タグで囲んで使うタグです。TreeOrder で並べた順序・親子関係をたどってオブジェクトを出力します。

mt:TreeOrder

ツリー順にオブジェクトをループ出力します（深さ優先順）。TreeOrder の基本となるブロックタグです。

<mt:TreeOrder class="entry" blog_id="1" limit="10">
  <div style="margin-left: <mt:TreeOrderDepth>em;">
    <mt:EntryTitle>
  </div>
</mt:TreeOrder>

<mt:TreeOrder class="content_data" content_type="ニュース">
  <mt:ContentLabel>
</mt:TreeOrder>

モディファイア	必須	説明
`class`	○	`entry`、`page`、`content_data` のいずれか
`blog_id`		サイト ID（省略時は現在のサイトコンテキスト）
`content_type`		コンテンツタイプ名（content_data 時。`content_type_id` といずれか必須）
`content_type_id`		コンテンツタイプ ID（content_data 時。`content_type` といずれか必須）
`limit`		取得件数の制限
`offset`		取得開始位置（オフセット）
`top_level_only`		`1` でルート（一番上の階層）のアイテムのみ取得

mt:TreeOrderAncestors

現在のアイテムの祖先を、ルートから順に出力します。mt:TreeOrder ブロックの中で使用してください。パンくずリストに便利です。

<mt:TreeOrder class="entry">
  <mt:EntryTitle>
  パンくず: <mt:TreeOrderAncestors glue=" &gt; "><mt:EntryTitle></mt:TreeOrderAncestors>
</mt:TreeOrder>

モディファイア	説明
`glue`	アイテム間の区切り文字

mt:TreeOrderDescendants

現在のアイテムの子孫を、深さ優先順で出力します。

<mt:TreeOrder class="entry" top_level_only="1">
  <mt:EntryTitle> の子孫:
  <mt:TreeOrderDescendants max_depth="3" include_current="1">
    <div style="margin-left: <mt:TreeOrderDepth>em;"><mt:EntryTitle></div>
  </mt:TreeOrderDescendants>
</mt:TreeOrder>

モディファイア	説明
`max_depth`	取得する最大の深さ
`include_current`	`1` で自身を含める

mt:TreeOrderChildren

現在のアイテムの直接の子アイテムだけを出力します（孫以降は含みません）。

<mt:TreeOrder class="page">
  <mt:PageTitle>
  <mt:TreeOrderChildren>
    - <mt:PageTitle>
  </mt:TreeOrderChildren>
</mt:TreeOrder>

mt:TreeOrderParent

現在のアイテムの親アイテムのコンテキストで、1 回だけ実行されます。親が無い（ルートの）場合は実行されません。

<mt:TreeOrder class="entry">
  <mt:EntryTitle>
  <mt:TreeOrderParent>（親: <mt:EntryTitle>）</mt:TreeOrderParent>
</mt:TreeOrder>

mt:TreeOrderSiblings

現在のアイテムの兄弟アイテム（同じ親を持つアイテム）を出力します。

<mt:TreeOrder class="entry">
  <mt:EntryTitle> の兄弟:
  <mt:TreeOrderSiblings include_current="0">
    <mt:EntryTitle>
  </mt:TreeOrderSiblings>
</mt:TreeOrder>

モディファイア	説明
`include_current`	`0` で自身を除外（デフォルト: `1`）