列表页标签

列表页标签用于栏目列表页模板，显示该栏目下的文章列表和相关信息。

常用标签

栏目信息标签

标签 说明 示例
{$category.name} 栏目名称 技术分享
{$category.description} 栏目描述 分享技术文章和经验
{$category.slug} 栏目别名 tech_share
{$category.seo_title} SEO 标题 技术分享 - 编程文章

文章列表标签

{loop $articles $article}
<div class="article-item">
    <h3><a href="{$BASE_URL}/posts/{$article.category_id}/{$article.id}.html">
        {$article.title}
    </a></h3>
    {if $article.thumb}
    <img src="{$article.thumb}" alt="{$article.title}">
    {/if}
    <p>{$article.description}</p>
    <div class="meta">
        <span>作者：{$article.author_name}</span>
        <time>{$article.published_at}</time>
        <span>浏览量：{$article.views}</span>
    </div>
</div>
{/loop}

分页标签

{if $pagination}
<div class="pagination">
    {if $pagination.prev_url}
    <a href="{$pagination.prev_url}">上一页</a>
    {/if}
    
    {loop $pagination.pages $page}
    <a href="{$page.url}" {if $page.current}class="current"{/if}>
        {$page.number}
    </a>
    {/loop}
    
    {if $pagination.next_url}
    <a href="{$pagination.next_url}">下一页</a>
    {/if}
</div>
{/if}

完整示例

<!DOCTYPE html>
<html lang="zh-CN">
<head>
    <title>{$category.seo_title} - {$setting.site_name}</title>
</head>
<body>
    <header>
        <h1>{$category.name}</h1>
        {if $category.description}
        <p>{$category.description}</p>
        {/if}
    </header>
    
    <main>
        {if $articles}
        {loop $articles $article}
        <article class="article-item">
            <h2><a href="{$BASE_URL}/posts/{$article.category_id}/{$article.id}.html">
                {$article.title}
            </a></h2>
            {if $article.thumb}
            <img src="{$article.thumb}" alt="{$article.title}">
            {/if}
            <p>{$article.description}</p>
            <div class="meta">
                <span>作者：{$article.author_name}</span>
                <time>{$article.published_at}</time>
                <span>浏览量：{$article.views}</span>
            </div>
        </article>
        {/loop}
        {else}
        <p>该栏目下还没有文章</p>
        {/if}
        
        {if $pagination}
        <div class="pagination">
            <!-- 分页代码 -->
        </div>
        {/if}
    </main>
</body>
</html>
提示： 更多详细信息请查看 模板标签系统 和 基础语法 文档。