在Django中如何为图片输入添加Widget组件？

在Django中，模型的ImageField对应的表单默认Widget是ClearableFileInput，你可以像配置普通输入字段一样，在表单类的widgets字典里为图片字段设置自定义属性。

修改forms.py代码 #

先确保导入ClearableFileInput，再在widgets中添加img字段的配置：

from django.forms import ModelForm, TextInput, ClearableFileInput
from .models import Book

class BookForm(ModelForm):
    class Meta:
        model = Book
        fields = ['name', 'img']
        widgets = {
            'name': TextInput(attrs={
                'class': 'form-control',
                'placeholder': 'Name'
            }),
            'img': ClearableFileInput(attrs={
                'class': 'form-control-file',
                'accept': 'image/*'  # 限制仅接受图片格式文件
            })
        }

修改HTML表单 #

文件上传的表单必须添加enctype="multipart/form-data"属性，否则无法正常接收上传的图片：

<form method="post" enctype="multipart/form-data">
  {% csrf_token %}
     {{ form.name }}<br>
     {{ form.img }}
     <button type="submit" class="btn btn-success">submit</button>
    <span>{{ error }}</span>
 </form>

关键注意点 #

• 使用ClearableFileInput必须先导入该类
• enctype="multipart/form-data"是文件上传表单的必填属性，缺失会导致图片无法上传
• 通过attrs可以为图片输入框添加样式类、文件类型限制等自定义配置

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