VVCMS5 Logo
首页 / 开发文档 / 主题开发
主题开发

主题开发:渲染变量与数据约束(ViewModel 约定)

解释模板渲染变量、字段约束与兼容策略:缺字段/空列表/分页等。

2026-03-04 0

为什么要有数据约束

同一套主题会跑在不同站点数据上:栏目数量、文章字段、扩展字段可能不完整。主题必须具备降级渲染能力。

1. 常见渲染变量(示例)

  • .Site:站点信息
  • .Columns:栏目树/导航
  • .List:列表页数据
  • .Pager:分页信息
  • .Single:详情页内容对象

2. 字段约束建议

  • 标题必填:缺失时显示“未命名”
  • 封面图可选:缺失时显示占位图或隐藏图片区域
  • 摘要可选:缺失时截取正文前 N 字
  • 标签可选:缺失时不渲染标签区域

3. 扩展字段(ext)使用建议

  • 当 ext 作为 map 使用时,访问建议用 index 防止缺 key 报错
  • 对 ext 值做类型兜底(字符串/数字/布尔)

4. 列表为空的处理

列表为空时建议显示:

  • “暂无内容”提示
  • 返回首页/返回上级栏目链接

5. 分页约束

分页组件要能处理:

  • 只有 1 页(不显示分页)
  • 第一页/最后一页边界