在AnQiCMS中，构建一个功能完善的留言表单是与用户进行有效互动、收集反馈或获取潜在客户信息的重要途径。令人欣喜的是，借助其强大的模板标签系统，特别是guestbook标签，我们可以轻松地在前台页面创建并展示一个动态、灵活的留言表单，而无需编写复杂的后端代码。

灵活构建留言表单的核心：guestbook标签

guestbook标签是AnQiCMS专为在线留言功能设计的一个强大工具。它不再需要我们手动定义表单的每一个字段，而是像一个智能助手，直接从后台预设的留言表单配置中读取所有的字段信息，然后自动将其渲染到前台页面。这意味着，您在后台对留言表单的任何结构性调整（例如增加、删除或修改字段类型），都能实时、动态地反映在前台，极大地提高了开发和运营效率。

通常情况下，您会在模板目录下的guestbook.html文件里使用这个标签，它是专门用于显示在线留言页面的默认模板文件。

使用guestbook标签的基本语法非常简洁：

{% guestbook fields %}
    {# 在这里循环输出表单字段 #}
{% endguestbook %}

在这里，fields是我们自定义的一个变量名，它会承载后台配置的所有留言表单字段数据。在{% guestbook fields %}和{% endguestbook %}之间，我们可以通过循环fields变量来动态地生成表单的各个输入项。

深入理解表单字段的构成

fields变量是一个包含多个表单字段对象的数组，每个对象都代表了您在后台设置的一个表单项。在循环过程中，我们可以通过item（或您自定义的任何变量名）来访问每个字段的详细属性：

  • item.Name：这是表单字段的显示名称，也就是用户在表单上看到的标签文本，例如“您的姓名”、“联系方式”。
  • item.FieldName：这是系统内部识别的字段名，用于表单提交时数据绑定的键名，例如user_name、contact。
  • item.Type：定义了表单输入框的类型，AnQiCMS支持多种类型，包括text（单行文本）、number（数字）、textarea（多行文本）、radio（单选）、checkbox（多选）和select（下拉选择）。
  • item.Required：一个布尔值，指示该字段是否为必填项。如果是true，您可以在前端添加相应的验证提示。
  • item.Content：通常用作文本输入框的placeholder（占位符）文本，或作为字段的默认值。
  • item.Items：当item.Type为radio、checkbox或select时，Items会是一个数组，包含了所有可供选择的选项值。

掌握了这些属性，我们就可以构建一个能够适应后台配置变化的动态表单了。

逐步构建动态留言表单代码

下面是一个完整的示例代码片段，它展示了如何使用guestbook标签遍历所有后台定义的字段，并根据字段类型动态生成HTML表单元素：

<form method="post" action="/guestbook.html">
    {% guestbook fields %}
        {% for item in fields %}
        <div>
            <label for="{{ item.FieldName }}">{{ item.Name }}</label>
            <div>
                {% if item.Type == "text" or item.Type == "number" %}
                <input type="{{ item.Type }}" id="{{ item.FieldName }}" name="{{ item.FieldName }}" 
                       {% if item.Required %}required{% endif %} 
                       placeholder="{{ item.Content }}" autocomplete="off">
                {% elif item.Type == "textarea" %}
                <textarea id="{{ item.FieldName }}" name="{{ item.FieldName }}" 
                          {% if item.Required %}required{% endif %} 
                          placeholder="{{ item.Content }}" rows="5"></textarea>
                {% elif item.Type == "radio" %}
                    {%- for val in item.Items %}
                    <input type="{{ item.Type }}" id="{{ item.FieldName }}_{{ loop.index }}" name="{{ item.FieldName }}" value="{{ val }}" 
                           {% if item.Content == val %}checked{% endif %}>
                    <label for="{{ item.FieldName }}_{{ loop.index }}">{{ val }}</label>
                    {%- endfor %}
                {% elif item.Type == "checkbox" %}
                    {%- for val in item.Items %}
                    <input type="{{ item.Type }}" id="{{ item.FieldName }}_{{ loop.index }}" name="{{ item.FieldName }}[]" value="{{ val }}" 
                           {% if item.Content contains val %}checked{% endif %}>
                    <label for="{{ item.FieldName }}_{{ loop.index }}">{{ val }}</label>
                    {%- endfor %}
                {% elif item.Type == "select" %}
                <select id="{{ item.FieldName }}" name="{{ item.FieldName }}">
                    {%- for val in item.Items %}
                    <option value="{{ val }}" {% if item.Content == val %}selected{% endif %}>{{ val }}</option>
                    {%- endfor %}
                </select>
                {% endif %}
            </div>
        </div>
        {% endfor %}

        {# 验证码区域，如果后台开启了验证码，这里需要添加 #}
        {# 具体的验证码集成代码请参考 FAQ 部分或相关文档 #}

        <div>
            <div>
                <button type="submit">提交留言</button>
                <button type="reset">重置</button>
            </div>
        </div>
    {% endguestbook %}
</form>

这段代码首先包裹在一个form标签中，action属性指向/guestbook.html（这是AnQiCMS处理留言提交的默认路径），method为post。

在for循环内部，我们使用if...elif...else结构判断item.Type来生成不同类型的表单元素：

  • 对于text和number类型，生成input标签，并设置type、name、id、required和placeholder属性。
  • 对于textarea类型，生成textarea标签，同样设置相应属性。
  • 对于radio、checkbox和select类型，会再次嵌套一个for循环来遍历item.Items数组，为每个选项生成input或option标签。这里我们还额外添加了id和label，以提高可访问性。

通过这种方式，无论后台配置多少字段，或者字段类型如何变化，前台页面都能智能地生成对应的表单，实现了真正的动态化。

提交表单注意事项

当用户填写并提交表单时，数据会发送到action属性指定的/guestbook.html路径。AnQiCMS会自动接收并处理这些数据。

有几个标准字段，即使您没有在后台明确设置，也建议在表单中包含，或者确保您的自定义字段能覆盖类似的功能：

  • user_name：留言者的姓名。
  • contact：留言者的联系方式（如手机、邮箱、微信等）。
  • content：留言的具体内容。

此外，您还可以添加一个名为return的隐藏字段来指定后端返回的格式，例如html或json，这在您需要通过AJAX异步提交表单时会非常