# 特殊標簽 * [ ] `標簽介紹` cms:commentlist用于調用[文檔](https://doc.fastadmin.net/docs/)或單頁的評論列表。 * [ ] `使用范圍`：詳情頁、單頁詳情頁。 ***** > 標簽參數： | 名稱 | 介紹 | 必選 | | --- | --- | --- | | id | 列表循環變量 | 是 | | empty | 數列為空時顯示的數據 | 否 | | key | 列表循環鍵名變量,默認為`i` | 否 | | condition| 篩選條件,可使用SQL字段篩選| 否 | | row | 篩選的行數,默認為10 | 否 | | orderby| 排序字段,支持id,createtime,updatetime,rand(隨機),weigh(權重)| 否 | | orderway|排序方式,asc=正序,desc=倒序 | 否 | | limit | 篩選的行數,優先使用row配置 | 否 | | imgwidth | 圖片寬度 | 否 | | imgheight | 圖片高度 | 否 | | mod | 取模基數，常用于控制多少條數據后換行、變色等 | 否 | |type | 類型,支持page=單頁,archives=文檔 | 否 | | aid | 單頁或文檔ID | 否 | | pid | 父評論ID | 否 | | fragment| 錨點元素ID| 否 | >調用示例 ``` {cms:commentlist id="comment" type="[type]" aid="$aid" pagesize="10"} //這里面可以調用cms_comment表的所有字段數據 {$comment.id} {$comment.createtime|human_date} {$comment.content} //還可以調用user表的數據 {$comment.user.id} {$comment.user.avatar} {$comment.user.nickname} {/cms:commentlist} ``` #### fa_cms_comment表中的參考字段 ``` CREATE TABLE `fa_cms_comment` ( `id` int(10) unsigned NOT NULL AUTO_INCREMENT COMMENT 'ID', `user_id` int(10) unsigned NOT NULL DEFAULT '0' COMMENT '會員ID', `type` enum('archives','page','special') NOT NULL DEFAULT 'archives' COMMENT '類型', `aid` int(10) unsigned NOT NULL DEFAULT '0' COMMENT '關聯ID', `pid` int(10) NOT NULL DEFAULT '0' COMMENT '父ID', `content` longtext COMMENT '內容', `comments` int(10) unsigned NOT NULL DEFAULT '0' COMMENT '評論數', `ip` varchar(50) DEFAULT '' COMMENT 'IP', `useragent` varchar(255) DEFAULT '' COMMENT 'User Agent', `subscribe` tinyint(1) unsigned NOT NULL DEFAULT '0' COMMENT '訂閱', `createtime` int(10) unsigned NOT NULL DEFAULT '0' COMMENT '創建時間', `updatetime` int(10) unsigned NOT NULL DEFAULT '0' COMMENT '更新時間', `deletetime` int(10) DEFAULT NULL COMMENT '刪除時間', `status` enum('normal','hidden') NOT NULL DEFAULT 'normal' COMMENT '狀態', PRIMARY KEY (`id`), KEY `post_id` (`aid`,`pid`) USING BTREE ) ENGINE=InnoDB AUTO_INCREMENT=4 DEFAULT CHARSET=utf8mb4 COMMENT='評論表'; ```