在安企CMS的强大功能矩阵中，为用户提供流畅的站点导航体验至关重要，而prevArchive标签正是实现这一目标的关键之一。它允许我们在当前文档页面轻松地获取并展示“上一篇”文档的信息，极大地提升了用户的阅读连续性和网站的交互性。作为一名资深的网站运营专家，我深知将技术细节转化为实用策略的重要性，接下来，我们将深入探讨prevArchive标签返回的prev变量中，究竟包含了哪些您可以直接调用的文档属性，以及如何巧妙运用它们。

prevArchive标签的核心作用与prev变量的本质

当您在AnQiCMS的模板中使用{% prevArchive prev %}...{% endprevArchive %}这样的结构时，系统会智能地识别当前文档，并为您填充prev这个变量。这个prev变量，实际上代表着一个完整的文档（或称“文章”、“产品”等，取决于您的内容模型）对象。因此，它能够承载的属性非常丰富，远不止一些简单的标题或链接。

我们可以将prev变量理解为当前内容模型下，满足特定排序规则（通常是发布时间或ID倒序）的“前一个”文档的完整数据实体。这意味着，凡是您能在archiveDetail标签中调用的文档属性，大多数都可以在prev变量中直接获取，让您在构建上一篇/下一篇导航时拥有极高的自由度和灵活性。

接下来，我们就来详细梳理这些可以直接调用的文档属性：

一、文档基本识别与展示信息

这些是构成文档最基础和最核心的属性，通常用于直接向用户展示。

  • Id (文档 ID): 每一篇文档在系统中都有一个唯一的数字标识。当您需要引用或进一步处理上一篇文档时，prev.Id是其不可或缺的身份证明。
  • Title (文档标题): 这是上一篇文档的H1标题，直接调用prev.Title即可在页面上呈现。
  • Link (文档链接): 访问上一篇文档的URL地址，通过prev.Link可以构建直接跳转的链接。
  • Keywords (文档关键词): 上一篇文档设置的关键词，可以通过prev.Keywords获取，用于SEO或内容关联。
  • Description (文档描述): 上一篇文档的简介，通常是文章摘要，调用prev.Description即可获取。
  • CategoryId (文档分类 ID): 上一篇文档所属分类的ID，通过prev.CategoryId可以得知其分类归属。
  • Views (文档浏览量): 上一篇文档的阅读或浏览次数，prev.Views可用于展示人气指标。
  • CommentCount (文档评论数量): 上一篇文档获得的评论总数，prev.CommentCount能够体现内容的互动性。

二、内容详情与SEO优化属性

为了提供更丰富的内容预览和支持SEO策略，prev变量同样包含了详细内容和SEO相关的属性。

  • SeoTitle (文档 SEO 标题): 如果上一篇文档单独设置了针对搜索引擎的标题，prev.SeoTitle将返回该值。这对于在导航提示中提供更精准的SEO信息非常有用。
  • Content (文档内容): 这是上一篇文档的完整正文内容。当您需要展示简短预览或者某些特定场景下需要完整内容时，可以直接调用prev.Content。请注意，为了安全和正确渲染HTML内容，通常需要结合|safe过滤器使用，例如{{ prev.Content|safe }}。如果文档内容是Markdown格式，您还可以使用|render过滤器进行转换。
  • ContentTitles (文档内容的标题列表): 如果上一篇文档内容结构化良好，含有多个H标签，prev.ContentTitles将返回一个包含这些子标题（及其层级、标签等信息）的数组，这在生成小型内容目录或快速浏览时非常实用。
  • CanonicalUrl (文档规范链接): 对于存在重复内容或URL标准化需求的情况，prev.CanonicalUrl会返回上一篇文档的规范链接，有助于搜索引擎正确识别主版本。

三、多媒体资源属性

图片是内容吸引力的重要组成部分，prev变量也提供了多种图片相关的属性。

  • Logo (文档封面首图): 通常是文档的主要缩略图或第一张特色图片，prev.Logo直接返回其URL。
  • Thumb (文档封面缩略图): 系统根据内容设置自动生成的缩略图，prev.Thumb返回其URL，常用于列表和导航的小图展示。
  • Images (文档封面图片组): 如果上一篇文档是组图类型或包含多张特色图片，prev.Images会返回一个包含所有图片URL的数组，您可以遍历这个数组来展示多图预览。

四、时间戳属性

时间是内容鲜度的重要指标，prev变量提供了文档的创建和更新时间。

  • CreatedTime (文档添加时间): 文档首次创建的时间戳。
  • UpdatedTime (文档更新时间): 文档最后一次更新的时间戳。

需要注意的是，这两个属性返回的是10位时间戳，为了在页面上以可读的日期格式显示，您需要结合AnQiCMS的stampToDate标签进行格式化，例如：{{ stampToDate(prev.CreatedTime, "2006-01-02") }}。

五、高级与自定义属性

除了上述通用属性，prev变量作为文档对象，还能进一步访问更多底层或自定义数据。

  • ModuleId (文档模型 ID): 上一篇文档所属内容模型的ID。
  • ParentId (上级文档 ID): 如果上一篇文档是子文档（例如，多级产品详情中的某个子项），prev.ParentId会返回其上级文档的ID。
  • UserId (文档的用户 ID): 发布上一篇文档的用户的ID。
  • Price (价格), Stock (库存), ReadLevel (阅读等级), OriginUrl (原文链接), Flag (推荐属性): 这些是根据内容模型特性可能存在的属性，例如在产品模型中可能调用prev.Price，或者判断prev.Flag来显示“推荐”或“头条”标识。
  • Category (完整分类对象): prev.Category实际上会返回一个完整的分类对象，您可以进一步访问prev.Category.Title、prev.Category.Link等属性，获取上一篇文档所属分类的详细信息，而不仅仅是ID。
  • 文档标签 (通过tagList调用): 虽然prev本身不直接提供一个Tags属性数组，但您可以结合tagList标签，传入itemId=prev.Id来获取上一篇文档的所有相关标签。
  • 文档模型设置的其他自定义字段参数: 如果您的内容模型定义了额外的自定义字段（例如“作者”、“来源”），这些字段也会作为prev对象的直接属性存在，您可以像调用内置属性一样直接访问，例如prev.Author。如果需要遍历所有自定义参数，可以结合archiveParams标签，传入id=prev.Id。

实用代码示例

理解这些属性后，我们可以构建一个既美观又实用的“上一篇”导航区。以下是一个常见的示例：

”`twig {# 使用 prevArchive 标签获取上一篇文档数据 #} {% prevArchive prev %}

{#