说明:用于获取文章常规列表、相关文章列表、文章分页列表

使用方法:{% articleList 变量名称 with categoryId="1" order="id desc|views desc" type="page|list|related" q="搜索关键词" %} 如将变量定义为 articles {% articleList articles with type="page" %}...{% endarticleList %} articleList 支持的参数有: categoryId,可以获取指定分类的文章列表如 categoryId="1" 获取文章分类ID为1的文章列表;order 可以指定文章显示的排序规则,支持依据 最新文章排序 order="id desc"、浏览量最多文章排序 order="views desc";显示数量 limit数量的列表,比如limit="10"则只会显示10条; 列表类型 type,支持按 page、list、related 方式列出。默认值为list,type="list" 时,只会显示 指定的 limit 指定的数量,如果type="page" 后续可用 分页标签 pagination 来组织分页显示 {% pagination pages with show="5" %};搜索关键词 q,如果需要搜索内容,可以通过参数q来展示指定包含关键词的标题搜索内容如 q="seo" 呈现结果将只显示标题包含seo关键词的列表。

item 为 for循环体内的变量,可用的字段有:

  • 文章ID Id
  • 文章标题 Title
  • 文章链接 Link
  • 文章关键词 Keywords
  • 文章描述 Description
  • 文章内容 Content
  • 文章分类ID CategoryId
  • 文章浏览量 Views
  • 文章封面图片 Images
  • 文章封面首图 Logo
  • 文章封面缩略图 Thumb
  • 文章分类 Category
  • 文章添加时间 CreatedTime 时间戳,需要使用格式化时间戳为日期格式 {{stampToDate(item.CreatedTime, "2006-01-02")}}
  • 文章更新时间 UpdatedTime 时间戳,需要使用格式化时间戳为日期格式 {{stampToDate(item.UpdatedTime, "2006-01-02")}}
{# list 列表展示 #}
<div>

{% articleList articles with type="list" order="views desc" categoryId="1" limit="10" %}

{% for item in articles %} <li class="item layui-flex"> <a href="{{item.Link}}" class="link flex-item"> <h5 class="title">{{item.Title}}h5> <div class="description">{{item.Description}}div> <div class="meta"> <span>{% categoryDetail with name="Title" id=item.CategoryId %}span> <span>{{stampToDate(item.CreatedTime, "2006-01-02")}}span> <span>{{item.Views}} 阅读span> div> a> {% if item.Thumb %} <a href="{{item.Link}}" class="thumb"> <img class="thumb-image" alt="{{item.Title}}" src="{{item.Thumb}}"> a> {% endif %} li> {% empty %} <li class="item empty"> 该列表没有任何内容 li> {% endfor %} {% endarticleList %} div> {# related 相关文章列表展示 #} <div> {% articleList articles with type="related" limit="10" %} {% for item in articles %} <li class="item layui-flex"> <a href="{{item.Link}}" class="link flex-item"> <h5 class="title">{{item.Title}}h5> <div class="description">{{item.Description}}div> <div class="meta"> <span>{% categoryDetail with name="Title" id=item.CategoryId %}span> <span>{{stampToDate(item.CreatedTime, "2006-01-02")}}span> <span>{{item.Views}} 阅读span> div> a> {% if item.Thumb %} <a href="{{item.Link}}" class="thumb"> <img class="thumb-image" alt="{{item.Title}}" src="{{item.Thumb}}"> a> {% endif %} li> {% empty %} <li class="item empty"> 该列表没有任何内容 li> {% endfor %} {% endarticleList %} div> {# page 分页列表展示 #} <div> {% articleList articles with type="page" limit="10" %} {% for item in articles %} <li class="item layui-flex"> <a href="{{item.Link}}" class="link flex-item"> <h5 class="title">{{item.Title}}h5> <div class="description">{{item.Description}}div> <div class="meta"> <span>{% categoryDetail with name="Title" id=item.CategoryId %}span> <span>{{stampToDate(item.CreatedTime, "2006-01-02")}}span> <span>{{item.Views}} 阅读span> div> a> {% if item.Thumb %} <a href="{{item.Link}}" class="thumb"> <img class="thumb-image" alt="{{item.Title}}" src="{{item.Thumb}}"> a> {% endif %} li> {% empty %} <li class="item empty"> 该列表没有任何内容 li> {% endfor %} {% endarticleList %} div> {# page 搜索指定关键词分页列表展示 #} <div> {% articleList articles with type="page" q="seo" limit="10" %} {% for item in articles %} <li class="item layui-flex"> <a href="{{item.Link}}" class="link flex-item"> <h5 class="title">{{item.Title}}h5> <div class="description">{{item.Description}}div> <div class="meta"> <span>{% categoryDetail with name="Title" id=item.CategoryId %}span> <span>{{stampToDate(item.CreatedTime, "2006-01-02")}}span> <span>{{item.Views}} 阅读span> div> a> {% if item.Thumb %} <a href="{{item.Link}}" class="thumb"> <img class="thumb-image" alt="{{item.Title}}" src="{{item.Thumb}}"> a> {% endif %} li> {% empty %} <li class="item empty"> 该列表没有任何内容 li> {% endfor %} {% endarticleList %} div> <div class="layui-box layui-laypage layui-laypage-default"> {% pagination pages with show="4" %} <a class="layui-laypage-first {% if pages.FirstPage.IsCurrent %}layui-laypage-curr{% endif %}" href="{{pages.FirstPage.Link}}">{{pages.FirstPage.Name}}a> {% if pages.PrevPage %} <a class="layui-laypage-prev" href="{{pages.PrevPage.Link}}">{{pages.PrevPage.Name}}a> {% endif %} {% for item in pages.Pages %} <a class="{% if item.IsCurrent %}layui-laypage-curr{% endif %}" href="{{item.Link}}">{{item.Name}}a> {% endfor %} {% if pages.NextPage %} <a class="layui-laypage-next" href="{{pages.NextPage.Link}}">{{pages.NextPage.Name}}a> {% endif %} <a class="layui-laypage-last {% if pages.LastPage.IsCurrent %}layui-laypage-curr{% endif %}" href="{{pages.LastPage.Link}}">{{pages.LastPage.Name}}a> {% endpagination %} div>