編輯“YulinCMS ContList標(biāo)簽說明”

<span style="text-align:center; border:1px solid #000; float:right; padding:6px;"><strong>導(dǎo)航:</strong> [[YulinCMS|上一頁]]</span>
<div style="clear:both;"></div>
==功能說明==
用于調(diào)用內(nèi)容列表

==適用范圍==
所有模板

==語法格式== 	
<pre>
 {Yu:ContList 屬性1="屬性值1" 屬性2="屬性值2"......}
 {NormalTemplate} 普通項模板 + 底層變量......{/NormalTemplate}   // 普通項模板元素
 {AlterTemplate} 交替項模板 + 底層變量......{/AlterTemplate}   // 交替項模板元素（可選）
 {SeparTemplate} 分隔符模板......{/SeparTemplate}   // 分隔符模板元素（可選）
 {ConditionTemplate} 條件輸出模板......{/ConditionTemplate}   // 條件輸出模板元素（可選）
 {/Yu:ContList}
</pre>

==模版元素 ==
*'''NormalTemplate '''	在內(nèi)容列表中的每一行都呈現(xiàn)一次的[[模板]]元素。
*'''AlterTemplate '''	與 NormalTemplate 元素類似，但在內(nèi)容列表中隔行（交替項）呈現(xiàn)一次。通過設(shè)置 AlterTemplate 元素的內(nèi)容，可以為其指定不同的外觀。
*'''SeparTemplate''' 	將呈現(xiàn)在內(nèi)容列表行之間。如果不設(shè)置，則不呈現(xiàn)分隔符內(nèi)容。
*'''ConditionTemplate '''當(dāng)專題數(shù)量達(dá)到 num 的倍數(shù)時，輸出該模板元素的內(nèi)容（num 為標(biāo)簽屬性 Condition 指定的數(shù)字值）
'''備注：'''如果沒有使用任何模板元素，則標(biāo)簽中的內(nèi)容被默認(rèn)為 NormalTemplate 普通項模板的內(nèi)容

==標(biāo)簽屬性==	
*'''ListType '''內(nèi)容列表的類型
屬性值可以是如下
#'''Normal '''普通內(nèi)容列表，用于所有模板。
#'''Category '''欄目頁內(nèi)容列表，僅用于欄目頁，可實現(xiàn)分頁，使用Count屬性來指定分頁大小。
#'''Relation '''相關(guān)內(nèi)容列表，僅用于內(nèi)容頁模板。
#'''SpecRegion '''專題區(qū)域頁內(nèi)容列表，僅用于專題區(qū)域頁模板?？蓪崿F(xiàn)分頁，使用Count屬性來指定分頁大小。
#'''SearchResult '''高級搜索結(jié)果頁內(nèi)容列表，僅用于搜索結(jié)果頁。

不指定該屬性，則默認(rèn)為 Normal 普通內(nèi)容列表。

*'''Count'''調(diào)用內(nèi)容數(shù)量
不指定該參數(shù)，則默認(rèn)調(diào)用10篇內(nèi)容。

當(dāng)屬性 ListType = "Category" 或 "SpecRegion" 時該參數(shù)用來指定內(nèi)容列表的分頁大小

*'''Cate''' 調(diào)用指定欄目下的內(nèi)容
屬性值可以是
#'''Current '''調(diào)用當(dāng)前欄目的內(nèi)容（僅用于 欄目頁、內(nèi)容頁）
#'''Rand '''調(diào)用任意一個欄目下的內(nèi)容
#'''Id '''調(diào)用外層列表標(biāo)簽指定的欄目下的內(nèi)容

調(diào)用指定欄目的內(nèi)容 例如：Cate="13"

調(diào)用多個指定欄目的內(nèi)容 例如 Cate="2|5|13"

不指定該屬性則默認(rèn)調(diào)用所有欄目的內(nèi)容

當(dāng) ListType = "Category" 時該參數(shù)無效。

*'''IsChildCate 是否調(diào)用所有子欄目內(nèi)容
屬性值為 True(是) 或 False(否) 默認(rèn)為 True

當(dāng) ListType = "Category" 時該參數(shù)無效。

*'''Class '''調(diào)用指定欄目分類下的內(nèi)容
屬性值可以是
#'''Current''' 調(diào)用當(dāng)前欄目分類的內(nèi)容（僅用于 欄目頁、內(nèi)容頁）
#'''Rand '''調(diào)用任意一個欄目分類下的內(nèi)容

調(diào)用指定欄目分類的內(nèi)容 例如：Class="13"

調(diào)用多個指定欄目分類的內(nèi)容 例如 Class="2|5|13"

不指定該屬性則忽略該條件

當(dāng) ListType = "Category" 時該參數(shù)無效。

*'''CateGroup''' 欄目組別
屬性值可以是

'''Rand '''調(diào)用任意一個欄目組別下的內(nèi)容

調(diào)用指定欄目組的內(nèi)容 例如：CateGroup = "1"

調(diào)用多個指定欄目組的內(nèi)容 例如 CateGroup = "2|3|5"

如設(shè)置此屬性，則只顯示欄目組別等于 CateGroup 的內(nèi)容列表。不指定該屬性則忽略該條件

當(dāng) ListType = "Category" 時該參數(shù)無效。

*'''CateGroupNot''' 非欄目組別
屬性值可以是

'''Rand '''調(diào)用除任意一個欄目組外的欄目下的內(nèi)容

調(diào)用除指定欄目組外的欄目 例如：CateGroupNot = "1"

如設(shè)置此屬性，則只顯示欄目組不等于 CateGroupNot 的欄目列表。不指定該屬性則忽略該條件

當(dāng) ListType = "Category" 時該參數(shù)無效。

*'''ContGroup'''內(nèi)容組別
調(diào)用指定內(nèi)容組別的內(nèi)容 例如：ContGroup = "1"

調(diào)用多個指定內(nèi)容組的內(nèi)容 例如 ContGroup = "2|3|5"

如設(shè)置此屬性，則只顯示內(nèi)容組別等于 ContGroup 的內(nèi)容列表。不指定該屬性則忽略該條件

*'''ContGroupNot'''非內(nèi)容組別
調(diào)用除指定內(nèi)容組別外的內(nèi)容 例如：GroupNot = "1"

如設(shè)置此屬性，則只顯示內(nèi)容組別不等于GroupNot的內(nèi)容列表。不指定該屬性則忽略該條件

*'''Where '''調(diào)用特定條件的內(nèi)容
屬性值如下所示
#'''SubTitle '''調(diào)用帶副標(biāo)題的內(nèi)容
#'''TitlePicture''' 調(diào)用帶標(biāo)題圖片的內(nèi)容
#'''TitleFile '''調(diào)用帶標(biāo)題附件的內(nèi)容
#'''TitleMedia''' 調(diào)用帶標(biāo)題媒體的內(nèi)容
#'''Depict '''調(diào)用帶摘要內(nèi)容
#'''Outer '''調(diào)用指向外部鏈接的內(nèi)容
#'''Top''' 調(diào)用已置頂內(nèi)容
調(diào)用某種類型的內(nèi)容。例如 Where = "TitlePicture" 調(diào)用帶標(biāo)題圖片的內(nèi)容

調(diào)用多種類型的內(nèi)容。例如 Where = "TitlePicture|Depict" 調(diào)用帶標(biāo)題圖片或著帶摘要的內(nèi)容

調(diào)用同時具有多種類型的內(nèi)容.例如 Where = "TitlePicture&Depict" 調(diào)用同時帶標(biāo)題圖片和摘要的內(nèi)容

不指定參數(shù)則調(diào)用所有條件內(nèi)容。

*'''Flag''' 調(diào)用特定標(biāo)記的內(nèi)容
屬性值如下所示 (可自定義)
#'''Hot '''調(diào)用熱點內(nèi)容
#'''Recommend '''調(diào)用推薦內(nèi)容
#'''Topline''' 調(diào)用頭條內(nèi)容
#'''Picture '''調(diào)用含圖片的內(nèi)容
#'''MultiPicture''' 調(diào)用含組圖的內(nèi)容
#'''File '''調(diào)用帶附件的內(nèi)容
#'''Flash '''調(diào)用帶Flash的內(nèi)容
#'''Audio '''調(diào)用帶音頻的內(nèi)容
#'''Video '''調(diào)用帶視頻的內(nèi)容
調(diào)用某種標(biāo)記的內(nèi)容。例如 Flag = "Picture" 調(diào)用含圖片的內(nèi)容

調(diào)用多種標(biāo)記的內(nèi)容。例如 Flag = "Hot|Picture" 調(diào)用熱點內(nèi)容或含圖片內(nèi)容

調(diào)用同時具有多種標(biāo)記的內(nèi)容.例如 Flag = "Hot&Picture" 調(diào)用同時具有熱點和含圖片的內(nèi)容

不指定參數(shù)則忽略該條件

*'''Spec '''調(diào)用指定專題下的內(nèi)容
屬性值可以是
#'''Current''' 調(diào)用當(dāng)前專題下的內(nèi)容（僅用于 專題內(nèi)容頁、專題分區(qū)頁）
#'''Id '''調(diào)用外層專題列表標(biāo)簽指定專題下的內(nèi)容

調(diào)用指定專題的內(nèi)容 例如：Spec = "13"

調(diào)用多個指定專題的內(nèi)容 例如 Spec = "12|13|15"

不指定該屬性則忽略該條件

*'''SpecRegion''' 調(diào)用指定專題區(qū)域下的內(nèi)容
屬性值可以是

'''Id''' 調(diào)用外層專題區(qū)域列表標(biāo)簽指定區(qū)域下的內(nèi)容

調(diào)用指定專題區(qū)域的內(nèi)容 例如：SpecRegion = "13"

調(diào)用多個指定專題的內(nèi)容 例如 SpecRegion = "12|13|15"

不指定該屬性則忽略該條件

當(dāng) ListType = "SpecRegion" 時該參數(shù)無效。

*'''Date '''調(diào)用指定日期的內(nèi)容
屬性值可以是
#'''Today''' 調(diào)用今天的內(nèi)容
#'''ThisWeek '''調(diào)用本周的內(nèi)容
#'''ThisMonth''' 調(diào)用本月的內(nèi)容
#'''ThisYear '''調(diào)用本年的內(nèi)容
#'''Yesterday '''調(diào)用昨天的內(nèi)容
#'''LastWeek '''調(diào)用上周的內(nèi)容
#'''LastMonth''' 調(diào)用上個月的內(nèi)容
#'''LastYear '''調(diào)用去年的內(nèi)容
也可以調(diào)用給定日期值的內(nèi)容，例如

調(diào)用指定日期的內(nèi)容 Date = "2007-6-13"

調(diào)用指定的多個日期的內(nèi)容 Date = "2007-6-13|2007-6-19"

調(diào)用指定日期段的內(nèi)容 Date = "2007-6-13>2007-6-19"

不指定該參數(shù)則默認(rèn)調(diào)用所有日期內(nèi)容

*'''LastDay '''調(diào)用最近幾天的內(nèi)容
例如：LastDay = "7" 只調(diào)用最近7天的內(nèi)容

*'''Keyword''' 調(diào)用標(biāo)題含有指定關(guān)鍵字的內(nèi)容
給定一個關(guān)鍵字 調(diào)用滿足條件的內(nèi)容 例如: Keyword = "word1"

給定多個關(guān)鍵字 調(diào)用滿足條件的內(nèi)容 例如: Keyword = "word1|word2|word3" (滿足任一關(guān)鍵字即調(diào)用)

給定多個關(guān)鍵字 調(diào)用滿足條件的內(nèi)容 例如: Keyword = "word1&word2&word3" (同時滿足全部關(guān)鍵字才調(diào)用)

不指定該屬性則忽略該條件

*'''Sort''' 內(nèi)容排序規(guī)則
屬性值可以是
#'''AddTime '''按錄入時間排序
#'''ClickTotal '''按點擊量排序
#'''CommTotal''' 按評論數(shù)排序
#'''FileDownTotal '''按標(biāo)題附件下載數(shù)量排序
#'''UpTotal '''按頂數(shù)量排序
#'''DownTotal '''按踩數(shù)量排序
#'''Id '''按內(nèi)容編號排序
#'''Rand '''隨機(jī)排序，可隨機(jī)獲取指定條件的內(nèi)容列表
不指定該屬性默認(rèn)以AddTime為排序規(guī)則

*'''Order''' 內(nèi)容排序方式
屬性值可以是
#'''ASC''' 遞增排序
#'''DESC''' 遞減排序

不指定該屬性默認(rèn)以DESC方式排序。

*'''Start'''調(diào)用內(nèi)容時的起始位置，和Count配合使用
例如: {Yu:ContList Count="10" Start="30"}.......{/Yu:ContList}

上面例子正好調(diào)用了 從第30條 -- 第40條記錄之間的 10條 記錄

*'''Cols'''內(nèi)容顯示列數(shù)
例如： Cols = "2"

不指定該屬性則默認(rèn)列數(shù)為1

*'''TableStyle'''列表表格的樣式，表示 <table 這里的內(nèi)容>
此屬性和 Cols 屬性配合使用，只有Cols大于1時有效。
*'''TrStyle'''列表表格的行樣式，表示 <tr 這里的內(nèi)容>
此屬性和 Cols 屬性配合使用，只有Cols大于1時有效。
*'''TdStyle''' 列表表格的單元格樣式,表示 <td 這里的內(nèi)容>
此屬性和 Cols 屬性配合使用，只有Cols大于1時有效。

*'''Condition'''條件輸出
例如 Condition = "num"

num為數(shù)字。內(nèi)容數(shù)量達(dá)到 num 的倍數(shù)時，輸出 ConditionTemplate 模板元素的內(nèi)容。

*'''TitleLen'''內(nèi)容標(biāo)題的顯示字符數(shù)量
不指定該屬性則默認(rèn)顯示完整的標(biāo)題

*'''TitleAddStr '''設(shè)置內(nèi)容標(biāo)題超出部分顯示的省略字串
例如: TitleAddStr ="..."

不指定該屬性則默認(rèn)為不追加任何省略字串

*'''DepictLen'''內(nèi)容摘要的顯示字符數(shù)量
不指定該屬性則默認(rèn)顯示完整的摘要

*'''DepictAddStr''' 設(shè)置內(nèi)容摘要超出部分顯示的省略字串
例如: DepictAddStr ="..."

不指定該屬性則默認(rèn)為不追加任何省略字串

*'''BodyLen'''內(nèi)容主體的顯示字符數(shù)量
不指定該屬性則默認(rèn)顯示完整的內(nèi)容主體

*'''BodyAddStr''' 設(shè)置內(nèi)容主體超出部分顯示的省略字串
例如: BodyAddStr ="..."

不指定該屬性則默認(rèn)為不追加任何省略字串

*'''NormalTemplateName '''普通項模板名稱
*'''AlterTemplateName''' 交替項模板名稱
*'''SeparTemplateName '''分隔符模板名稱
*'''ConditionTemplateName''' 條件輸出模板名稱

==底層變量==
*'''{@AutoId/}''' 自動Id。按照遞增方式自動產(chǎn)生Id，從 1 開始。通常用來表示行號。
*'''{@Id/}''' 內(nèi)容編號
*'''{@Title/}''' 內(nèi)容標(biāo)題
*'''{@FullTitle/}''' 完整標(biāo)題，此標(biāo)題不會被截取，通常作為鼠標(biāo)提示字串
*'''{@SubTitle/}''' 副標(biāo)題
*'''{@PicPath/}''' 標(biāo)題圖片
*'''{@SPicPath_1/}''' 標(biāo)題縮略圖 （1級 大小 300*200）
*'''{@SPicPath_2/}''' 標(biāo)題縮略圖 （2級 大小 150*100）
*'''{@SPicPath_3/}''' 標(biāo)題縮略圖 （3級 大小 90*60）
*'''{@MediaPath/}''' 標(biāo)題媒體
*'''{@FilePath/}''' 標(biāo)題附件
*'''{@FileSize/}''' 附件大小
*'''{@FileDownTotal/}''' 附件下載次數(shù)
*'''{@Author/}''' 內(nèi)容作者
*'''{@Source/}''' 內(nèi)容來源
*'''{@Body/}''' 內(nèi)容主體
*'''{@Depict/} '''內(nèi)容摘要
*'''{@Flag/}''' 內(nèi)容標(biāo)記
*'''{@ClickTotal/}''' 內(nèi)容點擊數(shù)量
*'''{@CommTotal/} '''評論數(shù)量
*'''{@UpTotal/} '''頂數(shù)量
*'''{@DownTotal/} '''踩數(shù)量
*'''{@ContPath/}''' 內(nèi)容頁路徑
*'''{@CommPath/} '''評論路徑
*'''{@CateId/}''' 所屬欄目的編號
*'''{@CateTitle/} '''所屬欄目標(biāo)題
*'''{@CatePath/}''' 所屬欄目路徑
*'''{@AddTime/}''' 內(nèi)容錄入時間
*'''{@AdminId/}''' 管理員ID
*'''{@AdminName/}''' 管理員名字

==使用示例==
查看[[YulinCMS ContList標(biāo)簽調(diào)用示例|ContList標(biāo)簽的使用示例]]

==相關(guān)條目==
*[[銳商CMS]]
*[[PageAdmin]]
*[[Umbraco]]
*[[DedeCMS]]
*[[帝國CMS]]
*[[Drupal]]

==參考來源==
*[http://help.yulincms.com/ 參考來源]

[[category:YulinCMS|C]]