织梦cms list标签调用新增字段

织梦CMS（DedeCMS）作为国内广泛使用的建站系统，其灵活的标签机制让网站内容调用变得便捷，但在实际运营中，常遇到需要调用新增字段的情况，比如文章的作者来源、标签分类、自定义评分等，本文将基于织梦官方二次开发规范及实际项目经验，详细讲解list标签如何正确调用新增字段，确保操作步骤清晰、结果稳定，适合有一定织梦基础的用户参考。

新增字段的准备工作

在通过list标签调用新增字段前,需先完成字段的添加与数据存储，这是基础前提，织梦的字段分为“主表字段”和“附加表字段”，主表（dede_archives）存储文章核心信息（标题、内容、发布时间等），附加表（如dede_addonarticle、dede_addonsoft等）存储扩展字段，具体取决于文章模型。

确定字段存储位置

• 主表字段：适用于核心且高频调用的字段，如“文章来源”“编辑姓名”等，直接在dede_archives表添加即可。
• 附加表字段：适用于特定模型的扩展字段，如文章模型的“摘要图”、软件模型的“文件大小”等，需在对应模型的附加表添加，例如普通文章模型对应dede_addonarticle，软件模型对应dede_addonsoft。

通过后台添加字段（推荐）

登录织梦后台,进入【系统】-【SQL命令工具】，执行ALTER TABLE语句添加字段，以普通文章模型为例，在附加表dede_addonarticle添加“book_author”（作者）字段：

ALTER TABLE `dede_addonarticle` ADD `book_author` VARCHAR(100) NOT NULL DEFAULT '';

字段类型可根据需求选择（VARCHAR、TEXT、INT等），NOT NULL表示不能为空，DEFAULT ''设置默认值为空字符串，添加后，需在【核心】-【内容模型管理】-【普通文章】中，点击“字段管理”，同步添加该字段到后台表单，勾选“使字段在列表页可调用”，确保字段能被正常录入和显示。

list标签调用新增字段的原理

织梦的list标签用于列表页内容调用,其基本结构为：

{dede:list pagesize='10'}
    <li>
        <a href="[field:arcurl/]">[field:title/]</a>
        <p>[field:book_author/]</p> <!-调用新增字段 -->
    </li>
{/dede:list}

核心在于：新增字段需在list标签的[field:自定义字段名/]中调用，且字段名必须与数据库中的字段名完全一致（区分大小写），织梦在解析list标签时，会自动关联主表或附加表，读取字段数据并输出。

不同场景下的调用方法

调用附加表字段（最常见）

以普通文章模型为例,新增字段“book_author”存储在dede_addonarticle表中，列表页调用时直接使用[field:book_author/]即可，无需额外处理，织梦list标签默认已关联附加表，可直接读取。

示例代码：

{dede:list pagesize='8'}
    <div class="list-item">
        <h2><a href="[field:arcurl/]" title="[field:title/]">[field:title function='cn_substr(@me,30)'/]</a></h2>
        <div class="info">
            <span>作者：[field:book_author/]</span>
            <span>时间：[field:pubdate function='MyDate('Y-m-d',@me)'/]</span>
        </div>
    </div>
{/dede:list}

注意事项：如果字段在附加表中，但调用时显示空白，需检查三点：① 字段是否已录入数据；② 字段名是否与数据库一致（如误将“book_author”写成“book_authors”）；③ 后台“字段管理”中是否勾选“使字段在列表页可调用”。

调用主表字段

若新增字段添加在dede_archives主表（如“source”来源字段），调用方式与附加表字段一致，直接使用[field:source/]即可，主表字段通常无需特殊处理，织梦list标签默认会读取主表数据。

示例：

{dede:list}
    <p>来源：[field:source/]</p>
{/dede:list}

调用自定义模型字段

如果使用了自定义模型（如“产品模型”“新闻模型”），需确保新增字段在对应模型的附加表中，调用时同样使用[field:字段名/]，但需注意模型ID是否正确——list标签默认调用当前栏目的模型，若栏目模型与字段所属模型不一致，需通过typeid属性指定模型ID。

示例（假设栏目ID为5，对应产品模型，附加表为dede_addonproduct，新增字段“price”）：

{dede:list typeid='5' pagesize='10'}
    <div class="product">
        <a href="[field:arcurl/]"><img src="[field:litpic/]" alt="[field:title/]"></a>
        <h3>[field:title/]</h3>
        <p>价格：¥[field:price/]</p>
    </div>
{/dede:list}

常见问题及解决方法

调用字段显示空白

• 原因1：字段未录入数据，检查后台对应文章是否有该字段的值。
• 原因2：字段名错误，核对数据库表中的字段名（如大小写、拼写），确保与[field:字段名/]完全一致。
• 原因3：字段未关联到列表页，进入后台“内容模型管理”-“字段管理”，勾选字段的“使字段在列表页可调用”。

调用后页面样式错乱

新增字段可能导致HTML结构变化,需检查[field:字段名/]是否被正确包裹在HTML标签内，避免因字段内容含特殊字符（如引号、尖括号）破坏页面结构，可通过织梦的“文本处理函数”过滤内容，如：

[field:book_author function='htmlspecialchars(@me)'/] <!-过滤HTML特殊字符 -->

列表页调用失败，报错“字段不存在”

• 原因：list标签默认调用当前栏目的模型字段，若新增字段属于其他模型，需通过typeid属性指定正确栏目ID（如问题3示例）。
• 解决：检查栏目“模型类型”是否与字段所属模型一致，不一致则修改栏目模型或调整typeid参数。

进阶技巧：字段值的二次处理

织梦支持对字段值进行函数处理,满足多样化显示需求。

• 截取字符串：[field:title function='cn_substr(@me,20)'/]截取前20字符）
• 日期格式化：[field:pubdate function='MyDate('Y-m-d H:i',@me)'/]（日期格式为“年-月-日 时:分”）
• 数字格式化：[field:price function='number_format(@me,2)'/]（价格保留两位小数）
• 自定义处理：通过/include/helpers/extend.helper.php添加自定义函数，再在标签中调用，如：

  // 在extend.helper.php中添加函数
  function getFirstChar($str) {
      return mb_substr($str, 0, 1, 'utf-8');
  }

  标签中调用：[field:book_author function='getFirstChar(@me)'/]（获取作者姓名首字符）

织梦CMS的list标签调用新增字段,核心在于“字段添加正确性”与“标签语法规范性”，操作流程可概括为：① 确定字段存储位置（主表/附加表）；② 通过SQL或后台添加字段并录入数据；③ 在列表模板中使用[field:字段名/]调用；④ 检查显示效果，解决常见问题，遵循以上步骤，即可灵活实现自定义字段的列表页调用，满足网站个性化需求。

织梦的二次开发需严格遵循官方规范,避免直接修改核心文件，以确保系统稳定性，对于复杂字段调用需求，建议参考织梦官方文档（https://help.dedecms.com/）或咨询专业开发者，以提升操作准确性和效率。

引用说明基于织梦CMS V5.7-V5.8官方二次开发指南及实际项目经验归纳，参考了织梦官方论坛（https://bbs.dedecms.com/）中关于字段调用的权威解答，并结合多个商业网站的测试案例，确保操作步骤的准确性和实用性。