Django表单自定义ImageField字段：仅展示img标签与文件选择输入框

问题原因 #

你遇到的字段显示多余内容的问题，是因为Django的FileField默认使用ClearableFileInput小部件渲染，默认会输出「当前文件链接+清空复选框+文件输入框」的组合内容，和你需要的效果不符。

解决方法 #

第一步：修改表单字段配置 #

把forms.py中的字段配置调整为使用普通FileInput小部件，去掉默认的多余元素：

from django.forms import FileInput

# 你可以保留FileField，也可以换成ImageField自带图片格式验证
image = forms.FileField(widget=FileInput)
# 或者用ImageField更贴合模型定义：
# image = forms.ImageField(widget=FileInput)

第二步：调整模板渲染逻辑 #

不要直接用{{form.image}}输出全部内容，手动拆分「已上传图片展示」和「文件输入框」两部分：

<!-- 展示已上传的图片（如果存在） -->
{% if form.instance.image %}
  <img src="{{ form.instance.image.url }}" alt="已上传图片" style="max-width: 300px; display: block; margin: 10px 0;">
{% endif %}
<!-- 输出文件选择框，仅用于更换图片 -->
{{ form.image }}

调整后即可实现你需要的效果：仅显示已上传图片的img标签，加一个用于更换图片的文件输入框，没有多余内容。 #

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