Crispy Form如何将指定字段渲染为纯静态HTML而非输入控件

你可以通过两种方式实现需求，不需要额外开发自定义字段类。 #

方案1：直接使用HTML组件动态赋值 #

你之前的写法不生效是因为Crispy的HTML类传入的字符串默认不会解析Django模板变量，需要在表单实例化阶段先拿到字段值，拼接进HTML字符串后再传入，示例代码如下：

from django import forms
from crispy_forms.helper import FormHelper
from crispy_forms.layout import Layout, HTML, Field

class MyForm(forms.Form):
    text = forms.CharField(label="文本字段")
    edit_field = forms.CharField(label="可编辑字段")

    def __init__(self, *args, **kwargs):
        super().__init__(*args, **kwargs)
        self.helper = FormHelper()
        # 获取text字段的实际值，模型表单取instance值，普通表单取initial值
        if hasattr(self, 'instance'):
            text_value = getattr(self.instance, 'text', '')
        else:
            text_value = self.initial.get('text', self.data.get('text', ''))
        
        self.helper.layout = Layout(
            # 拼接静态HTML，可搭配Bootstrap的form-control-static类保持样式统一
            HTML(f'''
            <div class="mb-3">
                <label class="form-label">{self.fields['text'].label}</label>
                <p class="form-control-static">{text_value}</p>
                {% if self.fields['text'].help_text %}
                <small class="form-text text-muted">{self.fields['text'].help_text}</small>
                {% endif %}
            </div>
            '''),
            # 正常渲染可编辑字段
            Field('edit_field'),
        )

方案2：自定义字段渲染模板（更推荐，复用性高） #

如果有多个只读字段需要处理，更推荐给字段指定自定义渲染模板，一次定义多次复用，无需手动拼接值：

1. 新建只读字段模板，路径为templates/crispy/readonly_field.html，内容如下：

<div class="mb-3">
    <label class="form-label">{{ field.label }}</label>
    <p class="form-control-static">{{ field.value|default:"-" }}</p>
    {% if field.help_text %}
    <small class="form-text text-muted">{{ field.help_text }}</small>
    {% endif %}
</div>

2. 在表单Layout中给需要只读的字段指定模板即可：

def __init__(self, *args, **kwargs):
    super().__init__(*args, **kwargs)
    self.helper = FormHelper()
    self.helper.layout = Layout(
        Field('text', template='crispy/readonly_field.html'),
        Field('edit_field'),
    )

该方案会自动读取字段的标签、帮助文本、当前值，完全不需要手动拼接参数，适配普通表单和模型表单，也不会生成任何输入控件。 #

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