易優arclist 文件列表(配合arcpagelist標籤可實現ajax瀑布流分頁)-Eyoucms標籤手冊

黄文Rex發表於2024-08-15

arclist 文件列表(配合arcpagelist標籤可實現ajax瀑布流分頁)

[基礎用法]
名稱：arclist
功能：獲取系統主從表模型（如：文章、軟體、圖集、產品等）的一列文件，也稱自由列表塊標記。
語法：

{eyou:arclist typeid='欄目ID' limit='0,10' flag='c' titlelen='30' infolen='160' orderby='add_time'}
<a href='{$field.arcurl}'>{$field.title}</a>
{/eyou:arclist}

引數：
typeid='' 欄目ID,在列表模板和內容頁模板中一般不需要指定，在首頁模板中允許用","分開表示多個欄目，但必須是同一個模型下的多個欄目ID，比如：文章模型、產品模型、圖集模型等；
notypeid='' 同typeid，但這裡是表示不包含這些屬性，與typeid不能同時存在；
tagid='' 在所有的arclist標籤中是唯一不可重複，對應arcpagelist標籤的tagid名稱，與arcpagelist配合使用可實現ajax瀑布流分頁；
row='10' 返回文件列表總數（建議不要與limit屬性同時存在，否則row無效）
limit='起始ID,記錄數' （起始ID從0開始）表示限定的記錄範圍（如：limit='1,3' 表示在3條記錄中，排除前面1條，也就是隻取得剩餘的後面所有記錄）
titlelen='30' 標題長度
infolen='160' 表示內容簡介長度
addfields='' 自定義欄位名，多個欄位之間用英文逗號隔開，比如：addfields='price,spce'
orderby='new' 文件排序方式
----orderby='hot' 或 orderby='click' 表示按點選數從高到低排序
----orderby='add_time' 按釋出時間最新排序
----orderby='aid' 按ID從大到小排序
----orderby='sort_order' 按排序號從小到大排序
----orderby='rand' 隨機排序
----orderby='is_recom desc, sort_order asc' 自定義多欄位組合排序
orderWay='desc' 排序型別：desc表示從大到小，asc表示從小到大
channelid='' 頻道ID，優先順序高於欄目ID，僅次於文件ID
flag='t,c' 自定義屬性值：推薦[c]跳轉[j]
noflag='' 同flag，但這裡是表示不包含這些屬性
empty='' 沒有資料時顯示的文案
mod='' 每隔N行輸出的內容
thumb='on' 預設使用縮圖，on為開啟，off為關閉
id='' 可以任意指定迴圈裡的變數名替代field，假設id='field1'，模板呼叫如：{$field.title} 變成 {$field1.title}
底層欄位：
請查閱易優Cms官方提供的資料字典，找到表名 ey_archives

-------------------------------效果展示--------------------------------
1，呼叫指定欄目文章
模板呼叫程式碼

{eyou:arclist typeid='2' row='5' titlelen='30' }
<li><a href="{$field.arcurl}" title="{$field.title}">{$field.title}</a></li>
{/eyou:arclist}

網站前端顯示效果（css樣式請自行填充）

【更多示例】
-------------------------------示例1--------------------------------
描述：每隔3條輸出文件記錄

{eyou:arclist typeid='文件ID' limit='0,10' mod='3'}
{eyou:eq name='mod' value='0'}
<a href='{$field.arcurl}'>{$field.title}</a>
{/eyou:eq}
{/eyou:arclist}

-------------------------------示例2--------------------------------
描述：mod屬性還用於控制一定記錄樣式，每隔3條增加樣式，比如：3、6、9……

{eyou:arclist typeid='文件ID' limit='0,10' mod='3'}
<li {eyou:eq name='mod' value='0'}class="樣式名"{/eyou:eq}>
  <a href='{$field.arcurl}'>{$field.title}</a>
</li>
{/eyou:arclist}

-------------------------------示例3--------------------------------
描述：內建變數輸出資料索引與記錄順序，key 表示索引，預設從0開始；i 表示順序，預設從1開始。

{eyou:arclist typeid='文件ID' limit='0,5'}
{$key} - {$i}
{/eyou:arclist}

效果：
0 - 1
1 - 2
2 - 3
3 - 4
4 - 5
-------------------------------示例4--------------------------------
描述：沒有記錄時輸出文案提示，屬性empty支援直接傳入html語法（html裡只支援雙引號，禁止單引號）

{eyou:arclist typeid='文件ID' limit='0,10' empty='暫時沒有資料'}
    <a href='{$field.arcurl}'>{$field.title}</a>
{/eyou:arclist}

-------------------------------示例5--------------------------------
描述：自定義變數名

{eyou:arclist typeid='文件ID' limit='0,10' id='field2'}
<a href='{$field2.arcurl}'>{$field2.title}</a>
{/eyou:arclist}

typeid='' 欄目ID,在列表模板和內容頁模板中一般不需要指定，在首頁模板中允許用","分開表示多個欄目，但必須是同一個模型下的多個欄目ID，比如：文章模型、產品模型、圖集模型等；

相關文章