django Form控件
Django的Form主要具有一下两大功能:
-生成HTML的input标签
-编写From类
- 自己编写一个Form子类,抽象的概括了想要的表单
from django.forms import Form from django.forms import widgets from django.forms import fields class MyForm(Form): user = fields.CharField() gender = fields.ChoiceField() city = fields.CharField() pwd = fields.CharField()
- Form组件不生成一个form控件,只能定制其中的input标签
-包括input标签的type,格式限定,label文本
-type
插入field.Form 的widget属性 如: user = fields.CharField( initial=2, widget=widgets.RadioSelect(choices=((1,'上海'),(2,'北京'),)) ) TextInput(Input) NumberInput(TextInput) EmailInput(TextInput) URLInput(TextInput) PasswordInput(TextInput) HiddenInput(TextInput) Textarea(Widget) DateInput(DateTimeBaseInput) DateTimeInput(DateTimeBaseInput) TimeInput(DateTimeBaseInput) CheckboxInput Select NullBooleanSelect SelectMultiple RadioSelect CheckboxSelectMultiple FileInput ClearableFileInput MultipleHiddenInput SplitDateTimeWidget SplitHiddenDateTimeWidget SelectDateWidget
-格式限定,先引入from django import forms
然后,book=forms.ModelChoiceField()
Field required=True, 是否必须填写, widget=TextInput, HTML插件 hidden_widget = HiddenInput label=None, 用于生成Label标签或显示内容 initial=None, 初始值 help_text='', 帮助信息(在标签旁边显示) error_messages=None, 错误信息 {'required': '不能为空', 'invalid': '格式错误'} show_hidden_initial=False, 是否在当前插件后面再加一个隐藏的且具有默认值的插件(可用于检验两次输入是否一直) validators=[], 自定义验证规则 localize=False, 是否支持本地化 disabled=False, 是否可以编辑 label_suffix=None Label内容后缀 CharField(Field) max_length=None, 最大长度 min_length=None, 最小长度 strip=True 是否移除用户输入空白 IntegerField(Field) max_value=None, 最大值 min_value=None, 最小值 FloatField(IntegerField) ... DecimalField(IntegerField) max_value=None, 最大值 min_value=None, 最小值 max_digits=None, 总长度 decimal_places=None, 小数位长度 BaseTemporalField(Field) input_formats=None 时间格式化 DateField(BaseTemporalField) 格式:2015-09-01 TimeField(BaseTemporalField) 格式:11:12 DateTimeField(BaseTemporalField)格式:2015-09-01 11:12 DurationField(Field) 时间间隔:%d %H:%M:%S.%f ... RegexField(CharField) regex, 自定制正则表达式 max_length=None, 最大长度 min_length=None, 最小长度 error_message=None, 忽略,错误信息使用 error_messages={'invalid': '...'} EmailField(CharField) ... FileField(Field) allow_empty_file=False 是否允许空文件 ImageField(FileField) ... 注:需要PIL模块,pip3 install Pillow 以上两个字典使用时,需要注意两点: - form表单中 enctype="multipart/form-data" - view函数中 obj = MyForm(request.POST, request.FILES) URLField(Field) ... BooleanField(Field) ... NullBooleanField(BooleanField) ... ChoiceField(Field) ... choices=(), 选项,如:choices = ((0,'上海'),(1,'北京'),) required=True, 是否必填 widget=Select, 插件,默认select插件 label=None, Label内容 initial=None, 初始值 help_text='', 帮助提示 ModelChoiceField(ChoiceField) ... django.forms.models.ModelChoiceField queryset, # 查询数据库中的数据 empty_label="---------", # 默认空显示内容 to_field_name=None, # HTML中value的值对应的字段 limit_choices_to=None # ModelForm中对queryset二次筛选 ModelMultipleChoiceField(ModelChoiceField) ... django.forms.models.ModelMultipleChoiceField TypedChoiceField(ChoiceField) coerce = lambda val: val 对选中的值进行一次转换 empty_value= '' 空值的默认值 MultipleChoiceField(ChoiceField) ... TypedMultipleChoiceField(MultipleChoiceField) coerce = lambda val: val 对选中的每一个值进行一次转换 empty_value= '' 空值的默认值 ComboField(Field) fields=() 使用多个验证,如下:即验证最大长度20,又验证邮箱格式 fields.ComboField(fields=[fields.CharField(max_length=20), fields.EmailField(),]) MultiValueField(Field) PS: 抽象类,子类中可以实现聚合多个字典去匹配一个值,要配合MultiWidget使用 SplitDateTimeField(MultiValueField) input_date_formats=None, 格式列表:['%Y--%m--%d', '%m%d/%Y', '%m/%d/%y'] input_time_formats=None 格式列表:['%H:%M:%S', '%H:%M:%S.%f', '%H:%M'] FilePathField(ChoiceField) 文件选项,目录下文件显示在页面中 path, 文件夹路径 match=None, 正则匹配 recursive=False, 递归下面的文件夹 allow_files=True, 允许文件 allow_folders=False, 允许文件夹 required=True, widget=None, label=None, initial=None, help_text='' GenericIPAddressField protocol='both', both,ipv4,ipv6支持的IP格式 unpack_ipv4=False 解析ipv4地址,如果是::ffff:192.0.2.1时候,可解析为192.0.2.1, PS:protocol必须为both才能启用 SlugField(CharField) 数字,字母,下划线,减号(连字符) ... UUIDField(CharField) uuid类型 ...
-label
在对应限定类型中的label参数中输入
-提示错误信息,
Form的error_messages中指定 error_messages={'required': '标题不能为空', 'min_length': '标题最少为5个字符', 'max_length': '标题最多为20个字符'}
-标签的class,
在widget的attr参数中写定 如: widget=widgets.TextInput(attrs={'class': "form-control", 'placeholder': u'手机号码'}))
- 生成实例
-form_obj=Myform({}),输入一个字典类型,键值对的键会对应上input标签的name,值会传入其中
![](https://images.cnblogs.com/OutliningIndicators/ContractedBlock.gif)
class BaseForm(object): # This is the main implementation of all the Form logic. Note that this # class is different than Form. See the comments by the Form class for more # information. Any improvements to the form API should be made to *this* # class, not to the Form class. default_renderer = None field_order = None prefix = None use_required_attribute = True def __init__(self, data=None, files=None, auto_id='id_%s', prefix=None, initial=None, error_class=ErrorList, label_suffix=None, empty_permitted=False, field_order=None, use_required_attribute=None, renderer=None): self.is_bound = data is not None or files is not None self.data = data or {} self.files = files or {} self.auto_id = auto_id if prefix is not None: self.prefix = prefix self.initial = initial or {} self.error_class = error_class # Translators: This is the default suffix added to form field labels self.label_suffix = label_suffix if label_suffix is not None else _(':') self.empty_permitted = empty_permitted self._errors = None # Stores the errors after clean() has been called. # The base_fields class attribute is the *class-wide* definition of # fields. Because a particular *instance* of the class might want to # alter self.fields, we create self.fields here by copying base_fields. # Instances should always modify self.fields; they should not modify # self.base_fields. self.fields = copy.deepcopy(self.base_fields) self._bound_fields_cache = {} self.order_fields(self.field_order if field_order is None else field_order) if use_required_attribute is not None: self.use_required_attribute = use_required_attribute # Initialize form renderer. Use a global default if not specified # either as an argument or as self.default_renderer. if renderer is None: if self.default_renderer is None: renderer = get_default_renderer() else: renderer = self.default_renderer if isinstance(self.default_renderer, type): renderer = renderer() self.renderer = renderer
-加入response
- render(request,'',{'form':form_obj}),
-验证用户数据
-接收request数据。
-生成一个自定制的from类
-验证数据,得出一个结果,
- 编写验证规则
- django自带的规则
- 自定义规则
from django.forms import Form from django.forms import widgets from django.forms import fields from django.core.validators import RegexValidator class MyForm(Form): phone = fields.CharField(min_length=11,max_length=11, validators=[RegexValidator(r'^[0-9]+$', '请输入数字'), RegexValidator(r'^159[0-9]+$', '数字必须以159开头')], )
validators作用是附加验证
validators数据类型为列表,每个元素是RegexValidator的实例,第一个参数是正则表达式,第二个参数是抛出的错误信息。
- 自定义逻辑规则:
if data['againpwd'] and data['againpwd'] != data['password']: reg_obj.add_error('againpwd', '两次密码不一致') #实时的加入对应错误信息 errors_dict = {'errors': list(reg_obj.errors)} return render(request, 'register.html', {'regform': reg_obj, 'errors_list': errors_dict})
-局部自定义钩子函数
def clean_username(self): # 函数名和和input框名字一样,只作用于相应字段 print('woshi clean_username') def clean_password(self): print('woshi clean_password') def clean_passworddfsdfs(self): print('woshi clean_passworddfsdfs')
- 验证,得出判断结果
- form_obj.is_vaild()会得到一个布尔型的返回值
- 上一步之前,cleaned_data是没有值的
- 以form形式提交收到错误,然后标红对应input框
- input标签下面errors属性(列表类型)
- 在Html中用模板语言取到错误信息,包括错误input框name和其错误信息
- 使用js取 ,把name做成一个列表,然后用字典的方式送到网页,用js取出,{{errorlist| safe}} js要用safa关键字
- form_obj
-如果结果不对,自动修改input标签样式
- 取到错误信息的name,用js修改
form控件接受数据,提交数据库:一对一提交,以及一对多提交 :
- clean_data 中 一对一关系,ModelChoiceField字段,收到的是一个对应的表的实例
一对多关系,ModelMultipleChoiceField ,收到的是一个Queryset 实例。
- 实际上数据中,多对多关系,会新建一张表,这张表的内容依赖其他两张建立关系的表而存在
- 多对多关系表插入数据必须要在主表插入相应数据之后
- 具体插入使用 主表相应实例对象的多对多字段的add方法
- add方法可以插入对应副表的pk值,pk值列表,副表对象,Queryset对象,Queryset的数据类型是列表,要注明(加*)