Django 提供一个辅助类来让你可以从Django 的模型创建表单。生成的表单类中将具有和指定的模型字段对应的表单字段,顺序为fields 属性中指定的顺序。
ForeignKey 和 ManyToManyField 字段类型
ForeignKey 表示成django.forms.ModelChoiceField,它是一个ChoiceField,其选项是模型的查询集。 ManyToManyField 表示成django.forms.ModelMultipleChoiceField,它是一个MultipleChoiceField,其选项是模型的查询集。
生成的每个表单字段都有以下属性集
模型字段设置blank=True,则required=True。 表单字段的label 设置为模型字段的verbose_name,并将第一个字母大写。 表单字段的help_text 设置为模型字段的help_text。 如果模型字段设置了choices,那么表单字段的Widget 将设置成Select,其选项来自模型字段的choices。选项通常会包含空选项,并且会默认选择。如果字段是必选的,它会强制用户选择一个选项。如果模型字段的blank=False 且具有一个显示的default 值,将不会包含空选项(初始将选择default 值)。
示例
model
from django.db import models TITLE_CHOICES = ( (‘MR‘, ‘Mr.‘), (‘MRS‘, ‘Mrs.‘), (‘MS‘, ‘Ms.‘), ) class Author(models.Model): name = models.CharField(max_length=100) title = models.CharField(max_length=3, choices=TITLE_CHOICES) birth_date = models.DateField(blank=True, null=True) class Book(models.Model): name = models.CharField(max_length=100) authors = models.ManyToManyField(Author)
forms.py
from django.forms import ModelForm, Textarea from django.utils.translation import ugettext_lazy as _ from django.core.exceptions import ValidationError from model_form.models import Author def validate_begins(value): """自定义验证器""" if not value.startswith(u‘new‘): raise ValidationError(u‘字符串必须是 `new` 开头‘) class AuthorForm(ModelForm): # 使用自定义的字段 # name = MyFormField(max_length=200, required=False, validators=[validate_slug] def __init__(self, *args, **kwargs): print("执行顺序1:init") # 自定义ModelForm中的field验证规则 super(AuthorForm, self).__init__(*args,**kwargs) self.fields[‘name‘].required = True self.fields[‘city‘].validators.append(validate_begins) def clean_name(self): """自定义验证方法""" print("执行顺序2:clean_name") value = self.cleaned_data[‘name‘] if value == ‘root‘: return value else: raise ValidationError("你不是管理员!") def clean(self): print("执行顺序3: name") # 不符合需求的字段不会出现在cleaned_data中 cleaned_data = super(AuthorForm, self).clean() password = cleaned_data.get(‘password‘, ‘‘) password2 = cleaned_data.get(‘password2‘, ‘‘) if password != password2: raise forms.ValidationError("passwords not match") return cleaned_data class Meta: print("启动Django时就执行了") model = Author # fields = ‘__all__‘ # 显示全部字段 # exclude = ‘title‘ # 排除某个字段 fields = [‘name‘, ‘title‘, ‘city‘,] # 决定显示哪些字段与显示顺序 # model中指定editable=False时,任何表单都不会包含该字段。 labels = {‘name‘: _(‘姓名‘),} help_texts = {‘name‘: _(‘Some useful help text.‘),} error_messages = { ‘name‘: {‘required‘: _("This writer‘s name is too long."),}, ‘birth_date‘: {‘required‘: _("时间不能为空"),}, }
时间: 2024-10-16 03:38:17