如何按自定义HTML结构渲染Django表单？求表单方法文档链接

直接使用{{ user_form }}会触发Django默认的表单渲染逻辑，生成额外的<div>、帮助文本等元素，破坏你的自定义样式。要完全复用你已有的HTML结构，需要手动渲染每个表单字段，具体方法如下：

1. 逐个渲染字段（匹配你的原有结构） #

把模板中的{{ user_form }}替换为以下代码，完全保留你原来的CSS类和HTML结构，同时利用Django表单的字段属性保证功能正常：

<form action="">
    <label for="{{ user_form.username.id_for_label }}"> Username</label>
    <input type="text" name="{{ user_form.username.name }}" id="{{ user_form.username.id_for_label }}" class="input" value="{{ user_form.username.value|default:'' }}">
    <!-- 可选：添加错误提示 -->
    {% if user_form.username.errors %}
        {% for error in user_form.username.errors %}
            <span class="error-text">{{ error }}</span>
        {% endfor %}
    {% endif %}

    <label for="{{ user_form.password.id_for_label }}"> Password</label>
    <input type="password" name="{{ user_form.password.name }}" id="{{ user_form.password.id_for_label }}" class="input">
    {% if user_form.password.errors %}
        {% for error in user_form.password.errors %}
            <span class="error-text">{{ error }}</span>
        {% endfor %}
    {% endif %}
</form>

这里用到的核心字段属性：

• {{ field.id_for_label }}：生成label标签for属性的正确值，确保点击label能聚焦对应输入框
• {{ field.name }}：获取字段的name属性，保证表单提交时参数名和Django表单定义一致
• {{ field.value|default:'' }}：保留用户已输入的内容（比如校验失败后不丢失输入）
• {{ field.errors }}：获取字段的校验错误信息列表

2. 批量渲染字段（适合多字段表单） #

如果表单字段较多，可通过循环遍历所有字段，同时维持自定义结构：

<form action="">
    {% for field in user_form %}
        <label for="{{ field.id_for_label }}">{{ field.label }}</label>
        <input type="{{ field.field.widget.input_type }}" name="{{ field.name }}" id="{{ field.id_for_label }}" class="input" value="{{ field.value|default:'' }}">
        {% if field.errors %}
            {% for error in field.errors %}
                <span class="error-text">{{ error }}</span>
            {% endfor %}
        {% endif %}
    {% endfor %}
</form>

注意：{{ field.field.widget.input_type }}会自动识别输入框类型（如text、password），但如果是单选框、复选框等特殊控件，需要额外添加判断逻辑适配。

表单模板API参考 #

关于表单对象、字段对象在模板中可用的所有属性和方法，可查阅Django官方文档的「表单字段的模板API」章节，里面涵盖了错误处理、控件渲染、属性获取等所有细节。

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