Django模板中用for循环遍历表单时如何显示help_text属性

解决方案 #

Django 内置的 as_p、as_ul、as_table 等表单快捷渲染方法会自动封装并输出字段的 help_text 属性，手动遍历字段时需要主动调用该属性展示。
直接修改模板循环部分的代码即可：

{% for field in form.visible_fields %}
<div>
  {{field.label_tag}}
  {{field}}
  <!-- 新增help_text展示，可先判断是否存在避免空标签 -->
  {% if field.help_text %}
    <span class="helptext">{{ field.help_text }}</span>
  {% endif %}
  <!-- 可选补充：同步展示字段校验错误信息 -->
  {% for error in field.errors %}
    <span class="form-error">{{ error }}</span>
  {% endfor %}
</div>
{% endfor %}

补充说明 #

• 输出的 field.help_text 会默认经过Django的内容转义处理，无需额外处理安全风险
• 你可以根据需求自定义包裹help_text的标签和样式类，实现和项目UI统一的展示效果

内容的提问来源于stack exchange，提问作者Tariq Ahmed