# 特殊标签 * [ ] `标签介绍` 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='评论表'; ```