文檔參數(shù)篩選僅可用著文檔首頁(yè)或文檔分類的模板上，結(jié)合文檔分頁(yè)列表使用。

說(shuō)明：用于做根據(jù)文檔各項(xiàng)參數(shù)進(jìn)行列表組合篩選的篩選條件，如做房產(chǎn)網(wǎng)站的時(shí)候，可以根據(jù)房屋類型為住宅、商鋪、商住兩用 篩選，同時(shí)可以附加根據(jù)房屋大小為單間、一室一廳、兩室兩廳、三室兩廳等篩選，這種情況下就可以用到文檔參數(shù)篩選功能。

使用方法：{% archiveFilters 變量名 with allText="全部" %} 如將變量定義為 filters {% archiveFilters filters with allText="全部" %}...{% endarchiveFilters %}

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

• 模型ID moduleId moduleId 可以獲取指定模型的參數(shù)篩選，如 moduleId="1" 獲取文章模型的參數(shù)篩選。
• 全部關(guān)鍵詞 allText allText 設(shè)置全部關(guān)鍵詞是文字內(nèi)容，如“全部”，如果不想顯示，則設(shè)置 allText=false。
• 站點(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ù)。

filters 變量為一個(gè)數(shù)組對(duì)象，需要通過(guò) for 循環(huán)來(lái)輸出。for item 的對(duì)象結(jié)構(gòu)是：

• 參數(shù)名稱 Name

• 參數(shù)字段名 FieldName

• 該參數(shù)的可選值 Items Items 是一個(gè)數(shù)組對(duì)象，需要通過(guò) for 循環(huán)來(lái)輸出。 for val 的對(duì)象結(jié)構(gòu)是：

  • 篩選值 Label
  • 篩選值鏈接 Link
  • 是否選中 IsCurrent

代碼示例

{# 參數(shù)篩選代碼 #}
<div>
    <div>參數(shù)篩選：</div>
    {% archiveFilters filters with moduleId="1" allText="默認(rèn)" %}
        {% for item in filters %}
        <ul>
            <li>{{item.Name}}: </li>
            {% for val in item.Items %}
            <li class="{% if val.IsCurrent %}active{% endif %}"><a href="{{val.Link}}">{{val.Label}}</a></li>
            {% endfor %}
        </ul>
    {% endfor %}
    {% endarchiveFilters %}
</div>

{# 文檔列表代碼 #}
<div>
{% archiveList archives with moduleId="1" type="page" limit="10" %}
    {% for item in archives %}
    <li>
        <a href="{{item.Link}}">
            <h5>{{item.Title}}</h5>
            <div>{{item.Description}}</div>
            <div>
                <span>{% categoryDetail with name="Title" id=item.CategoryId %}</span>
                <span>{{stampToDate(item.CreatedTime, "2006-01-02")}}</span>
                <span>{{item.Views}} 閱讀</span>
            </div>
        </a>
        {% if item.Thumb %}
        <a href="{{item.Link}}">
            <img alt="{{item.Title}}" src="{{item.Thumb}}">
        </a>
        {% endif %}
    </li>
    {% empty %}
    <li>
        該列表沒有任何內(nèi)容
    </li>
    {% endfor %}
{% endarchiveList %}

    {# 分頁(yè)代碼 #}
    <div>
        {% pagination pages with show="5" %}
            {# 首頁(yè) #}
            <a class="{% if pages.FirstPage.IsCurrent %}active{% endif %}" href="{{pages.FirstPage.Link}}">{{pages.FirstPage.Name}}</a>
            {# 上一頁(yè) #}
            {% if pages.PrevPage %}
            <a href="{{pages.PrevPage.Link}}">{{pages.PrevPage.Name}}</a>
            {% endif %}
            {# 中間多頁(yè) #}
            {% for item in pages.Pages %}
            <a class="{% if item.IsCurrent %}active{% endif %}" href="{{item.Link}}">{{item.Name}}</a>
            {% endfor %}
            {# 下一頁(yè) #}
            {% if pages.NextPage %}
            <a href="{{pages.NextPage.Link}}">{{pages.NextPage.Name}}</a>
            {% endif %}
            {# 尾頁(yè) #}
            <a class="{% if pages.LastPage.IsCurrent %}active{% endif %}" href="{{pages.LastPage.Link}}">{{pages.LastPage.Name}}</a>
        {% endpagination %}
    </div>
</div>

常見使用實(shí)例

在一個(gè)房產(chǎn)文檔列表中，可以通過(guò)各種篩選條件，來(lái)顯示文檔，如圖：

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

<div>
    <div>房產(chǎn)篩選：</div>
    {% archiveFilters filters with moduleId="1" allText="不限" %}
        {% for item in filters %}
        <ul>
            <li>{{item.Name}}: </li>
            {% for val in item.Items %}
            <li class="{% if val.IsCurrent %}active{% endif %}"><a href="{{val.Link}}">{{val.Label}}</a></li>
            {% endfor %}
        </ul>
    {% endfor %}
    {% endarchiveFilters %}
</div>