Python之路71-Django form組件
阿新 • • 發佈：2017-05-28
python
目錄
一、介紹
二、示例
三、form類
四、常用選擇插件
五、自定義驗證規則
六、初始化數據
一、介紹
Django的form主要具有以下幾大功能
生成HTML標簽
驗證用戶數據（顯示錯誤信息）
HTML form提交保留上次提交數據
初始化頁面顯示內容
二、示例
url.py
from django.conf.urls import url
from django.contrib import admin
from app01 import views
urlpatterns = [
url(r‘^admin/‘, admin.site.urls),
url(r‘^fm/‘, views.fm),
]views.py
from django import forms
from app01 import models
from django.forms import widgets
from django.forms import fields
class FM(forms.Form):
# 字段本身只做驗證
user = fields.CharField(error_messages={"required": "用戶名不能為空"},
widget=widgets.Textarea(attrs={"class": "c1"}))
pwd = fields.CharField(
max_length=12,
min_length=6,
error_messages={"required": "密碼不能為空", "max_length": "密碼長度不能大於16", "min_length": "密碼長度不能小於6",},
widgets=widgets.PasswordInput()
)
email = fields.EmailField(error_messages={"required": "郵箱不能為空", "invalid": "郵箱格式錯誤"})
def fm(request):
if request.method == "GET":
obj = FM()
return render(request, "fm.html", {"obj": obj})
elif request.method == "POST":
# 獲取用戶的所有數據
# 每條數據請求的驗證
# 成功：獲取所有正確的信息
# 失敗：頁面顯示錯誤信息
obj = FM(request.POST)
res = obj.is_valid()
if res:
models.UserInfo.objects.create(**obj.cleaned_data)
else:
return render(request, "fm.html", {"obj": obj})fm.html
<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="UTF-8">
<title>Title</title>
</head>
<body>
<form action="/fm/" method="POST">
{% csrf_token %}
<p>{{ obj.user }}{{ obj.errors.user.0 }}</p>
<p>{{ obj.pwd }}{{ obj.errors.pwd.0 }}</p>
<p>{{ obj.email }}{{ obj.errors.email.0 }}</p>
<input type="submit" name="提交"/>
</form>
</body>
</html>三、form類
創建form類時，主要涉及到字段和插件，字段用於對用戶請求數據的驗證，插件用於自動生成HTML
1.Django內置字段
Field
required=True, 是否允許為空
widget=None, HTML插件
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=None, 插件，默認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類型
...註：UUID是根據MAC以及當前時間等創建的不重復的隨機字符串
>>> import uuid # make a UUID based on the host ID and current time
>>> uuid.uuid1() # doctest: +SKIP
UUID(‘a8098c1a-f86e-11da-bd1a-00112444be1e‘) # make a UUID using an MD5 hash of a namespace UUID and a name
>>> uuid.uuid3(uuid.NAMESPACE_DNS, ‘python.org‘)
UUID(‘6fa459ea-ee8a-3ca4-894e-db77e160355e‘) # make a random UUID
>>> uuid.uuid4() # doctest: +SKIP
UUID(‘16fd2706-8baf-433b-82eb-8c7fada847da‘) # make a UUID using a SHA-1 hash of a namespace UUID and a name
>>> uuid.uuid5(uuid.NAMESPACE_DNS, ‘python.org‘)
UUID(‘886313e1-3b8a-5372-9b90-0c9aee199e5d‘) # make a UUID from a string of hex digits (braces and hyphens ignored)
>>> x = uuid.UUID(‘{00010203-0405-0607-0809-0a0b0c0d0e0f}‘) # convert a UUID to a string of hex digits in standard form
>>> str(x) ‘00010203-0405-0607-0809-0a0b0c0d0e0f‘
# get the raw 16 bytes of the UUID
>>> x.bytes
b‘\x00\x01\x02\x03\x04\x05\x06\x07\x08\t\n\x0b\x0c\r\x0e\x0f‘
# make a UUID from a 16-byte string
>>> uuid.UUID(bytes=x.bytes)
UUID(‘00010203-0405-0607-0809-0a0b0c0d0e0f‘)2.Django內部插件
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
四、常用選擇插件
五、自定義驗證規則
六、初始化數據
本文出自 “八英裏” 博客，請務必保留此出處http://5921271.blog.51cto.com/5911271/1930342
Python之路71-Django form組件