>[info]RGCMS的欄目調用簡單方便，靈活性強，支持無限級
## **欄目調用**
標簽：`{rg:nav 參數名稱="參數值"}{/rg:nav}`
**參數列表**
|參數(?為可選參數)|默認值|使用示例|解釋|
|---|---|---|---|
|?pid|默認當前欄目ID|pid="5"或 pid="$nav_id" 或pid="$nav['id']"|上級欄目ID|
|?group||group="G1"|根據欄目分組標識進行調用|
|?model||model="news"|根據模型標識調用欄目|
|?id||id="1,2,3,4" <p style="color:orange">1.12新增：id=":get_navids('G1')"</p>|根據欄目ID進行調用|
|?eid||eid="5,6,7,8"<p style="color:orange">1.12新增：eid=":get_navids('G1')"</p>|排除特定ID的欄目|
|?empty||empty="無數據"|無結果時提示的文本|
|?where||where="id > 10"|根據條件進行篩選|
|?order|order asc,id desc|order="id asc"|排序規則|
|?status|1(默認調用開啟的欄目)|status="0"|調用開啟或關閉的欄目|
|?key|i|key="y"|循環體內的計數變量，如{$i}從1開始計數|
|?name|自定義(不可為nav)|name="nav2"|調用二級欄目或三級等，自定義的變量名稱|
|?limit|不限|limit="10"|調用數量|
|?site|當前站點ID|site="1"|站點ID|
>[warning]pid參數如果需要調用上一級的ID，必須使用數組形式，如：pid='$nav["id"]'
注意：**pid、group、model、id最多只能選擇一個調用**
>[success]童鞋們舉栗子了：
```
調用當前站點所有一級欄目，按照默認排序規則排序
<ul>
<li {if $nav_id==0}class="active"{/if}>
<a href="/">首頁</a>
</li>
{rg:nav}
<li {if $nav.id==$nav_top_id} class="active"{/if}>
<a href="{$nav.url}" {$nav.target}>{$nav.name}</a>
</li>
{/rg:nav}
</ul>
解釋：
1. {if $nav.id==$nav_top_id}**{/if} 就是如果當前循環到的欄目ID等于當前頁面的頂層欄目ID時顯示高亮狀態
2. 如果寫成這樣{if $nav.id==$nav_id}**{/if} 就是如果當前循環到的欄目ID等于當前頁面的ID時顯示高亮狀態
3. {$nav.url} 是當前欄目的URL
4. {$nav.*} *代表后臺欄目中對應的字段名稱，以及自定義的欄目擴展字段名稱
```
```
二級欄目調用，這個稍微加深點了
<ul>
<li {if $nav_id==0}class="active"{/if}>
<a href="/">首頁</a>
</li>
{rg:nav limit="5" order="order asc,id desc"}
<li {if $nav.id==$nav_top_id} class="active"{/if}>
<a href="{$nav.url}" {$nav.target}>{$nav.name}</a>
{if $nav.child>0}
<div>
{rg:nav pid='$nav["id"]' name='nav2'}
<a href="{$nav2.url}" {$nav2.target}>{$nav2.name}</a>
{/rg:nav}
</div>
{/if}
</li>
{/rg:nav}
</ul>
解釋：
1. {if $nav.child>0}**{/if} 判斷是否有子欄目
2. 每一級的name參數必須定義不同的變量名，不要與其他變量名有沖突
```
```
調用欄目分組
<ul>
{rg:nav group="G1" limit="4" order="order asc"}
<li>
<a href="{$nav.url}" {$nav.target}>{$nav.name}</a>
{if $nav.child}
<div>
{rg:nav pid='$nav["id"]' name='nav2'}
<a href="{$nav2.url}" {$nav2.target}>{$nav2.name}</a>
{/rg:nav}
</div>
{/if}
</li>
{/rg:nav}
</ul>
解釋：
1. group參數值為后臺欄目分組中，設定的分組標識
2. 當參數中存在group參數時，pid參數失效
```
```
左側分類，調用當前欄目頂級分類
<ul>
{rg:nav pid="$nav_top_id"}
<li>
<a href="{$nav.url}" {$nav.target}>{$nav.name}</a>
</li>
{/rg:nav}
</ul>
解釋：
$nav_top_id 為當前欄目頂級分類ID，$nav_id 為當前欄目ID
```
```
調用指定的欄目
<ul>
{rg:nav id="11,12,13"}
<li>
<a href="{$nav.url}" {$nav.target}>{$nav.name}</a>
</li>
{/rg:nav}
</ul>
解釋：
此時，將調用ID為11,12,13的欄目，并循環輸出信息
```
