說(shuō)明：用于獲取文章、產(chǎn)品分類列表

使用方法：{% categoryList 變量名稱 with moduleId="1|2|3" parentId="0" %} 如將變量定義為 categories {% categoryList categories with moduleId="1" parentId="0" %}...{% endcategoryList %}

categoryList 支持的參數(shù)有：

• 模型ID moduleId moduleId 可以獲取指定文檔模型的分類列表如 moduleId="1" 獲取文章模型的分類列表。
• 上級(jí)分類 parentId parentId 表示上級(jí)分類，可以獲取指定上級(jí)分類下的子分類，parentId="parent" 表示上級(jí)分類為當(dāng)前分類的上級(jí)分類，表示獲取當(dāng)前分類的兄弟分類。parentId=“0”的時(shí)候，獲取頂級(jí)分類。當(dāng)要獲取頂級(jí)分類的時(shí)候，必須指定模型ID moduleId
• 獲取全部分類 all all 可以獲取指定所有分類列表，如 all=true 獲取所有分類，如果同時(shí)指定了moduleId，則獲取指定模型下的所有分類。
• 顯示數(shù)量 limit limit 可以指定顯示數(shù)量，比如limit="10"則只會(huì)顯示10條，limit 支持offset模式，也就是 ,分隔模式，如想從第2條開始，獲取10條數(shù)據(jù)，可以設(shè)置成 limit="2,10"。
• 站點(diǎn)ID siteId siteId 一般不需要填寫，如果你使用后臺(tái)的多站點(diǎn)管理創(chuàng)建了多個(gè)站點(diǎn)，并且想調(diào)用其他站點(diǎn)的數(shù)據(jù)，則可以通過(guò)指定 siteId 來(lái)實(shí)現(xiàn)調(diào)用指定站點(diǎn)的數(shù)據(jù)。

如果想獲取當(dāng)前分類的下級(jí)分類，則不需要指定 parentId。如果想獲取當(dāng)前分類的兄弟分類，則指定 parentId="parent"，僅當(dāng)在文檔列表的時(shí)候有效。

categories 是一個(gè)數(shù)組對(duì)象，因此需要使用 for 循環(huán)來(lái)輸出

item 為for循環(huán)體內(nèi)的變量，可用的字段有：

• 分類ID Id
• 分類標(biāo)題 Title
• 分類鏈接 Link
• 分類描述 Description
• 分類內(nèi)容 Content
• 上級(jí)分類ID ParentId
• 分類縮略圖大圖 Logo
• 分類縮略圖 Thumb
• 下級(jí)分類前綴 Spacer
• 是否有下級(jí)分類 HasChildren
• 是否當(dāng)前鏈接 IsCurrent
• 分類的文檔數(shù)量 ArchiveCount

代碼示例

{% categoryList categories with moduleId="1" parentId="0" %}
<ul>
    {% for item in categories %}
    <li>        {#  如需判斷當(dāng)前是否是循環(huán)中的第一條，可以這么寫： #}
        {% if forloop.Counter == 1 %}這是第一條{% endif %}
        {# 比如需要給第一條添加額外class="active"，可以這么寫： #}
        <a class="{% if forloop.Counter == 1 %}active{% endif %}" href="{{item.Link}}">{{item.Title}}</a>
        <a href="{{ item.Link }}">{{item.Spacer|safe}}{{item.Title}}</a>
        <a href="{{ item.Link }}">
            <span>當(dāng)前第{{ forloop.Counter }}個(gè)，剩余{{ forloop.Revcounter}}ge</span>
            <span>分類ID：{{item.Id}}</span>
            <span>分類名稱：{{item.Title}}</span>
            <span>分類鏈接：{{item.Link}}</span>
            <span>分類描述：{{item.Description}}</span>
            <span>分類內(nèi)容：{{item.Content|safe}}</span>
            <span>上級(jí)分類ID：{{item.ParentId}}</span>
            <span>下級(jí)分類前綴：{{item.Spacer|safe}}</span>
            <span>是否有下級(jí)分類：{{item.HasChildren}}</span>
        </a>
        <div>縮略圖大圖：<img style="width: 200px" src="{{item.Logo}}" alt="{{item.Title}}" /></div>
        <div>縮略圖：<img style="width: 200px" src="{{item.Thumb}}" alt="{{item.Title}}" /></div>
    </li>
    {% endfor %}
</ul>
{% endcategoryList %}

多級(jí)分類嵌套調(diào)用

{% categoryList categories with moduleId="1" parentId="0" %}
{#一級(jí)分類#}
<ul>
    {% for item in categories %}
    <li>
        <a href="{{ item.Link }}">{{item.Title}}</a>
        <div>
            {% categoryList subCategories with parentId=item.Id %}
            {#二級(jí)分類#}
            <ul>
                {% for inner1 in subCategories %}
                <li>
                    <a href="{{ inner1.Link }}">{{inner1.Title}}</a>
                    <div>
                        {% categoryList subCategories2 with parentId=inner1.Id %}
                        {#三級(jí)分類#}
                        <ul>
                            {% for inner2 in subCategories2 %}
                            <li>
                                <a href="{{ inner2.Link }}">{{inner2.Title}}</a>
                            </li>
                            {% endfor %}
                        </ul>
                        {% endcategoryList %}
                    </div>
                </li>
                {% endfor %}
            </ul>
            {% endcategoryList %}
        </div>
    </li>
    {% endfor %}
</ul>
{% endcategoryList %}

常見使用實(shí)例

1. 在循環(huán)多個(gè)分類中顯示分類下的文檔。如圖：

調(diào)用代碼示例（代碼不包含css樣式控制）

{% categoryList categories with moduleId="1" parentId="0" %}
<div>
    {% for item in categories %}
    <div>
        <h3><a href="{{ item.Link }}">{{item.Title}}</a></h3>
        <ul>
            {% archiveList archives with type="list" categoryId=item.Id limit="6" %}
            {% for archive in archives %}
            <li>
                <a href="{{archive.Link}}">
                    <h5>{{archive.Title}}</h5>
                    <div>{{archive.Description}}</div>
                    <div>
                        <span>{{stampToDate(archive.CreatedTime, "2006-01-02")}}</span>
                        <span>{{archive.Views}} 閱讀</span>
                    </div>
                </a>
                {% if archive.Thumb %}
                <a href="{{archive.Link}}">
                    <img alt="{{archive.Title}}" src="{{archive.Thumb}}">
                </a>
                {% endif %}
            </li>
            {% empty %}
            <li>
                該列表沒(méi)有任何內(nèi)容
            </li>
            {% endfor %}
        {% endarchiveList %}
        </ul>
    </div>
    {% endfor %}
</div>
{% endcategoryList %}

1. 在循環(huán)多個(gè)分類中顯示分類的下級(jí)分類，如果沒(méi)有下級(jí)分類，則顯示分類的文檔。如圖：

調(diào)用代碼示例（代碼不包含css樣式控制）

<div>
    {% categoryList productCategories with moduleId="2" parentId="0" %}
    {% for item in productCategories %}
    <a href="{{item.Link}}">{{item.Title}}</a>
    <ul class="ind-pro-nav-ul">
        {% if item.HasChildren %}
            {% categoryList subCategories with parentId=item.Id %}
            {% for inner in subCategories %}
            <li><a href="{{inner.Link}}" title="">{{inner.Title}}</a></li>
            {% endfor %}
            {% endcategoryList %}
        {% else %}
            {% archiveList products with type="list" categoryId=item.Id limit="8" %}
            {% for inner in products %}
            <li><a href="{{inner.Link}}" title="">{{inner.Title}}</a></li>
            {% endfor %}
            {% endarchiveList %}
        {% endif %}
    </ul>
    {% endfor %}
    {% endcategoryList %}
</div>