Hkcms内容列表标签content
内容列表标签
查询模型数据列表、结合分页标签可实现分页、例如获取文章列表等可用该标签。
格式示例
// 获取模型ID为1的3条数据。{hkcms:content model="1" num="3"}<a href="{$item.url}">标题：{$item.title}</a>{/hkcms:content}参数
| 参数名称 | 可选值 | 默认值 | 是否必填 | 支持版本 | 说明 |
|---|---|---|---|---|---|
| catid | 栏目ID或变量,多个栏目使用英文逗号分隔,必须是同模型v2.2.3.220920+ | - | 在列表页可以不填,自动获取。 | - | 默认包含下级文章的内容 |
| model | - | - | - | - | 模型ID |
| aid | - | - | - | v2.2.3.220920+ | 指定单个文档ID |
| aids | 文档ID:1,2,3 | - | - | v2.2.3.220920+ | 指定多个文档ID,英文逗号分隔 |
| field | - | * | - | v2.2.3.221215+ | 指定显示的字段，默认是*表示所有，注意：系统已包含(id,lang,style,views,url,category_id,status)无需重复指定 |
| order | weigh asc,id desc | - | - | 排序 , 格式为 order="字段名称 desc" 其中desc是倒序，asc是升序 | |
| num | 格式为数字、变量、5,10 | 10 | - | - | 限制结果数量； 5,10：第五条开始，获取10条数据 |
| where | - | - | - | - | 数据库查询条件 |
| page | 1 | - | - - | 开启分页，配合 {hkcms:contentpage /} 分页标签 | |
| insub | 1-包含下级,0-不包含下级 | 1 | - | - | 需要与catid同时使用，默认包含下级文章 |
| inlist | 1-列表模式,0-单页内容 | 0 | - | - | 针对单页，填写catid时，获取catid下级的所有单页，支持分页 |
| more | 1 | - | - | v2.2.3.220920+不在使用 | 获取副表的数据 |
| flag | - | - | - | - | 文档属性值 |
| id | - | $item | - | - | 指定循环里的变量名，例如id='obj'，模板调用如：{$item.title} 变成 {$obj.title} |
| empty | - | - | - | - | 为空的时候输出提示，支持传入html |
| cache | - | 3600秒 | - | - | 缓存时间，默认3600秒，对非分页数据有效 |
| mod | - | - | - | v2.2.1.20220603+ | 控制隔N行输出的内容等，更多查看下面的示例 |
| key | - | - | - | v2.2.1.20220603+ | 指定循环变量，如果没有指定key属性的话，默认使用循环变量$i |
参数说明
catid 栏目ID或变量，在列表页时可不填，自动获取列表页的内容数据
获取属于栏目ID为7，数量为6条的文档
{hkcms:content catid="7" num="6"}// style字段是后台内容管理标题加粗、标题颜色，如果需要那么按以下写法获取<a href="{$item.url}" style="{$item.style}">标题：{$item.title}</a>封面图：<img src="{$item.thumb}"> // 更多字段可前往后台字段管理里面或手册数据字典里面查看{/hkcms:content}以变量形式获取，例如在列表页有当前栏目变量($Cate)，
catid="$Cate.id"$Cate.id是栏目ID，下面示例为获取当前栏目6条文档并开启分页
// page="1" 是开启分页{hkcms:content catid="$Cate.id" num="6" page="1"}<h5><a href="{$item.url}">标题：{$item.title}</a></h5>{/hkcms:content}在列表页，获取当前栏目的文档，可以不传
catid参数，如下按每页6条分页展示
{hkcms:content num="6" page="1"}<h5><a href="{$item.url}">{$item.title}</a></h5>{/hkcms:content}同时获取多个栏目ID的文档数据，catid="栏目ID1,栏目id2" 多个栏目ID使用英文逗号分隔开
{hkcms:content catid="11,12" num="6"}<a href="{$item.url}" style="{$item.style}">标题：{$item.title}</a>{/hkcms:content}aid 获取单条文章，如下获取文档ID为14的记录
{hkcms:content aid="14"}<a href="{$item.url}" style="{$item.style}">标题：{$item.title}</a>{/hkcms:content}aids 获取多条文章，多个文档使用英文逗号分隔开
{hkcms:content aids="14,15"}<a href="{$item.url}" style="{$item.style}">标题：{$item.title}</a>{/hkcms:content}model模型ID参数表示按模型id来获取记录，模型ID在模型管理里面可以看到
// 获取模型id为1的记录，num控制显示数量{hkcms:content model="1" num="5"}文档标题：{$item.title}文档描述：{$item.description}{/hkcms:content}order 用于字段排序，格式为order="字段名 asc,字段名2 desc"，其中asc 表示升序 desc 表示倒序，多个排序字段使用逗号分隔开
// 列表页，按最新发布的靠前排序{hkcms:content order="publish_time desc"}文档标题：{$item.title}文档描述：{$item.description}{/hkcms:content}num 用于控制记录条数，num="5" 表示只获取5条记录。也可以控制从第几条开始，5,10表示第5～15条记录。注意5,10格式不能用于分页上
注意这种限制范围方式不得用于分页{hkcms:content model="1" num="5,10"}标题：{$item.title}{/hkcms:content}动态控制每页展示文档条数可以在后台栏目管理里面配置（栏目管理-》添加-》更多-》分页大小）
动态文档条数写法示例，num="$Cate.num"，$Cate.num是当前栏目的分页大小
{hkcms:content num="$Cate.num" page="1"}// style字段是后台可设置加粗与颜色<a href="{$item.url}" style="{$item.style}">标题：{$item.title}</a>{/hkcms:content}where 数据库查询条件，语法跟SQL where基本相同。格式：where="字段名 = 1" ，支持传入变量
{// 获取模型id为1的记录，where条件意思是只显示阅读量大于1的记录}{hkcms:content model="1" where="views > 1"}标题：{$item.title}描述：{$item.description}{/hkcms:content}sql语法可参考：https://www.w3school.com.cn/sql/sql_where.asp
更多查询表达式参考：https://www.kancloud.cn/manual/thinkphp6_0/1037537
page 开启分页功能，默认是没有分页的，开启后配合contentpage分页标签来实现生成底部下的页码
{// page="1" 开启分页}{hkcms:content model="1" page="1"}标题：{$item.title}{/hkcms:content}insub 控制是否显示下级，该属性需要结合catid来使用，默认自动包含该栏目下的所有文档数据包含子级，值为1-包含下级，0-不包含下级。
// 不包括子级下的文档，注意获取的下级是跟当前栏目模型一致{hkcms:content catid="1" insub="0"}标题：{$item.title}{/hkcms:content}注意：获取下级栏目的文档是跟caitid里面的栏目ID模型一致
inlist 列表模式用于获取多条单页模型的文章。例如catid="1"栏目ID为1是单页栏目，那么默认情况下获取的是一条单页内容，获取该单页下所有单页栏目里的文档则可以使用该参数。示例如下：
开启列表模式，获取当前栏目下5条单页列表{hkcms:content catid="1" inlist="1" num="5"}<div>
{hkcms:raw name="$item['content']" /}</div>{/hkcms:content}more用于开启列表页获取副表字段。模型管理里面字段管理可以看到字段是否是主表还是副表，后续版本默认有副表字段无需手动开启
开启副表访问{hkcms:content model="1" more="1" num="5"}副表内容：{$item.content}{/hkcms:content}
