JEECMS的ArtiList標(biāo)簽使用實(shí)例

導(dǎo)航: 上一頁(yè)

【ArtiList 標(biāo)簽】在JEECMS中使用的頻率可以說(shuō)是最高的，通過(guò)這個(gè)標(biāo)簽，你不僅可以得到一個(gè)文章列表，而且可以通過(guò)不同的參數(shù)組合得到不同的顯示效果。比如文章圖文列表、文字或圖片跑馬燈、文字或圖片上下循環(huán)滾動(dòng)等等。

這里我們還是使用空白的首頁(yè)模板（index_demo.html）來(lái)演示標(biāo)簽的用法。

• 標(biāo)簽原型說(shuō)明

【標(biāo)簽名】：[@cms. ArtiList屬性='值' /]

【作 用】：獲取文章列表數(shù)據(jù)

【參 數(shù)】：

屬性名稱(chēng)	屬性說(shuō)明	默認(rèn)值	可選值
chnlId	欄目ID，欄目頁(yè)中可不設(shè)置，系統(tǒng)會(huì)自動(dòng)獲取當(dāng)前欄目ID	當(dāng)前欄目ID	空：顯示全站文章列表；欄目ID：指定欄目文章列表
attr	文章屬性ID	空	后臺(tái)自定義
sysContent	列表顯示方式	1-1	1-1：普通標(biāo)題列表顯示； 1-2：圖文列表顯示； 3-1：焦點(diǎn)圖顯示； 2-1：標(biāo)題列表翻滾顯示 2-2：圖文列表翻滾顯示
orderBy	排序方式	0	0：發(fā)布時(shí)間降序;1：發(fā)布時(shí)間升序；2：點(diǎn)擊次數(shù)降序；3：點(diǎn)擊次數(shù)升序
recommend	是否推薦	0	0：所有文章 1：推薦文章
titLen	標(biāo)題長(zhǎng)度	20	自定義
target	鏈接打開(kāi)目標(biāo)	0	0：原窗口打開(kāi) 1：新窗口打開(kāi)
headMark	文章標(biāo)題圖標(biāo)	0	0：無(wú)圖標(biāo) 1：黑色小圓點(diǎn) 2：紅色小圓點(diǎn) 3：藍(lán)色單箭頭 4：藍(lán)色雙箭頭 自定義圖標(biāo)：填寫(xiě)圖標(biāo)路徑
lineHeigh	文章列表每行的行高	空	自定義
ctgForm	文章類(lèi)別形式	0	0：不顯示文章類(lèi)別； 1：顯示欄目類(lèi)別； 2：顯示站點(diǎn)名稱(chēng)
dateFormat	文章發(fā)布日期顯示格式	0	0：不顯示日期 1：”年-月-日 時(shí)-分-秒” 格式 2：”年-月-日” 格式 3：”月-日 時(shí)-分” 格式
rollDisplayHeight	顯示區(qū)高度	28	自定義
rollLineHeight	行高	28	自定義
rollCols	列數(shù)（一行中包含幾列）	1	自定義
rollSpeed	滾動(dòng)速度，值越小越快，最小為1	1	自定義
isSleep	是否停頓	1	0：不停頓； 1：停頓
rollSleepTime	停頓時(shí)間，值越大停頓越久	50	自定義
rollCount	一次滾動(dòng)的行數(shù)	1	自定義
rollSpan	一次滾動(dòng)的像素	1	自定義

其它高級(jí)標(biāo)簽屬性（用于用戶(hù)個(gè)性設(shè)置）

屬性名稱(chēng)	屬性說(shuō)明	默認(rèn)值	可選值
searchKey	在標(biāo)題、tags和描述中搜索指定關(guān)鍵字的文章列表，用于搜索頁(yè)模板	空	自定義關(guān)鍵字
style	標(biāo)簽內(nèi)部樣式，如果指定sysContent或userContent，則該項(xiàng)無(wú)效	1	1：普通列表
sysTpl	指定系統(tǒng)模板	1	自定義
sysContent	系統(tǒng)內(nèi)容樣式	0	自定義
userContent	用戶(hù)內(nèi)容樣式，當(dāng)sysContent=1時(shí)有效	空	自定義
sysPage	系統(tǒng)分頁(yè)樣式	0	自定義
userPage	用戶(hù)分頁(yè)樣式，當(dāng)sysPage=1時(shí)有效	空	自定義
upSolution	指定其它模板方案樣式	空	自定義
upWebRes	指定其它站點(diǎn)樣式	空	自定義
pageClass	分頁(yè)欄css樣式的class名稱(chēng)	空	自定義
pageStyle	分頁(yè)欄css自定義style樣式	空	自定義
custom	用戶(hù)擴(kuò)展屬性集合	空	自定義

【示 例】： [@cms.ArtiList chnlId= count='5' sysContent='1-1' titLen='25' lineHeight='1' dateFormat='4' datePosition='2' headMark='2' target='1'/]

• 明確標(biāo)簽使用范圍

我們?cè)谑褂萌魏螛?biāo)簽的之前，都必須明確其使用的范圍，否則可能無(wú)法正常使用該標(biāo)簽。

【ArtiList 標(biāo)簽】的使用范圍是：

首頁(yè)模板，欄目頁(yè)模板，內(nèi)容頁(yè)模板，

即對(duì)應(yīng)\WEB-INF\user_base\jeecms_com_www\template\article\default\文件夾下的 index_識(shí)別ID.html模板、channel_識(shí)別ID.html模板、content_識(shí)別ID.html模板

• 調(diào)試標(biāo)簽了解其使用方法

登錄JEECMS后臺(tái)，進(jìn)入“模板管理?template?article?default”,點(diǎn)擊修改開(kāi)始時(shí)建立的index_demo.html模板（如果沒(méi)有此模板則按照本文開(kāi)頭的說(shuō)明創(chuàng)建），在模板內(nèi)容處填寫(xiě)如下標(biāo)簽代碼（為了演示效果美觀，本處代碼中引入了系統(tǒng)默認(rèn)css，可去除）：

文章列表

<link href="${sysResRoot}/front.css" type="text/css" rel="stylesheet" /> [@cms.ArtiList chnlId= count='5' sysContent='1' titLen='25' lineHeight='1' dateFormat='4' datePosition='2' headMark='2' target='1'/]

點(diǎn)保存按鈕，然后返回前臺(tái)站點(diǎn)首頁(yè)刷新，得到如下效果：

圖文列表

<link href="${sysResRoot}/front.css" type="text/css" rel="stylesheet" /> [@cms.ArtiList chnlId= attr='5' count='5' sysContent='2' titLen='25' target='1' picWidth='25' picHeight='110'/]

點(diǎn)保存按鈕，然后返回前臺(tái)站點(diǎn)首頁(yè)刷新，得到如下效果：