xiis内容详情点号标签在详情页的用法

xiis内容详情点号标签在详情页的用法

1024KB1024KB 使用手册 2026-08-02 14:20:00 浏览 65805 字数 1262

内容点号标签让详情页无需循环包裹,直接以点号语法输出当前内容的字段值。写法是 {xiis:内容.字段名},数据由详情页控制器一次性填充,字段访问走严格白名单,字段名不在映射表时回退到该内容自身的 meta 键查找。

基础字段的用法

基础字段覆盖内容的主表字段,标题、别名、摘要、正文、封面图片、作者名称、发布时间等都能直接输出。链接类字段有三个层次:基于 ID 的链接、基于别名的别名链接、由链接配置驱动的智能链接,模板中一律推荐使用智能链接,它会自动适配站点启用的 URL 形态。

字段标签写法说明
标题{xiis:内容.标题}内容标题
正文{xiis:内容.内容}富文本正文,渲染时保持 HTML
智能链接{xiis:内容.智能链接}由链接配置驱动,自动适配 slug 与后缀
分类名称{xiis:内容.分类名称}所属栏目名称,可搭配分类智能链接使用

上一篇与下一篇导航

相邻内容导航同样以点号语法输出,标题与链接成对出现:上一篇标题、上一篇链接、下一篇标题、下一篇链接,以及对应的别名链接与智能链接变体。详情页底部的上下篇区块不需要额外查询,直接引用字段即可。

Meta 字段与类型专属字段

Meta 字段来自内容的键值扩展表,解析机制分两步:先查映射表已知字段,再动态回退到数据键查找。SEO 标题、SEO 关键词、SEO 描述属于通用 meta 字段;文章类型另有来源链接与字数两个专属字段,产品类型有价格、库存、规格,视频类型有视频地址与时长。

动态回退让新增的 meta 键无需等待标签注册即可使用:数据库里新增一个键之后,直接用 {xiis:内容.自定义键名} 就能输出,未知字段与已知字段在写法上完全一致。

付费阅读状态字段

付费内容场景有一组状态字段:需付费、用户已登录、已购买、VIP 可免费、价格显示、试读字数等。这些字段既可以直接输出文案,也可以作为条件判断的输入,与条件判断标签配合即可按登录与购买状态渲染不同的购买按钮。

字段级时间格式与双语写法

时间类字段支持字段级格式参数,写法是在字段名后追加格式串,例如日期、中文日期、日期时间等格式都有对应的预设值。时间格式的优先级为字段级优先于列表级,详情页通常直接写字段级格式,避免受列表参数影响。

所有字段都提供英文别名写法,例如标题可写作 content.title、智能链接可写作 content.smart_link。中文与英文写法完全等价,同一模板中可以混用,团队按统一风格选择即可。

安全与边界

内容点号标签采用白名单加动态回退的双层机制:映射表内的字段直接取值,映射表外的字段名回退到本内容的 meta 键查找。整个查询过程绑定当前站点与当前内容,不存在跨内容取值或跨站点读取的路径;页面未注入内容上下文时,所有字段输出为空字符串。

掌握内容点号标签后,详情页模板可以写得非常薄:结构交给 HTML,数据全部由点号标签填充,新增 meta 字段时模板随字段增加即可。这也是把详情页从复杂的循环结构中解放出来的关键一步。

分享到:

评论

加载中...
我
还没有评论,快来抢沙发吧~