Django---forms表單使用（1）

時間 2019-12-15

原文原文鏈接

使用過Django的同窗應該都比較清楚，Django的表單功能是十分強大的，能夠完成數據的校驗等功能。html

下面講下經常使用的表單類型。咱們講下建立表單到前臺能夠正常顯示的步驟：前端

1、建立表單類(能夠直接在views.py文件中建立，也能夠本身再新建一個forms.py的模塊，而後寫到這個模塊下，我是單首創建的forms.py），列了九種，也差很少使用的頻率比較高的。python

from django import forms

class TestForm(forms.Form):
    name = forms.CharField(label='單行輸入',max_length=10)
    mulirow = forms.CharField(label="多行輸入",max_length=100,widget=forms.Textarea)
    choice = forms.ChoiceField(label='選擇框',choices=(
        ("learn","學習"),
        ("test","測試"),
        ("django","python"),
    ))
    bool = forms.BooleanField(required=False)
    urrf = forms.URLField(label="url格式")
    data=forms.DateField(label="日期格式")
    email = forms.EmailField(label="郵箱格式")
    file = forms.FileField(label="文件格式")
    imge = forms.ImageField(label="圖片上傳")

2、在views.py裏定義訪問函數git

from django.shortcuts import render

def learn_test(request):
    form = TestForm()
    return render(request,'test.html',{'form':form})

3、編寫test.htmlweb

<!DOCTYPE html>
<html lang="en">
<head>
    <meta charset="UTF-8">
    <title>Title</title>
</head>
<body>
<form>
    {% csrf_token %}
    {{ form.as_p }}
</form>
</body>
</html>

4、配置url正則表達式

from django.conf.urls import url
from web import views

urlpatterns = [
    url(r'^test/$',views.learn_test),
]

5、啓動服務而後前端訪問數據庫

在Terminal下啓動服務：python manage.py runserverdjango

瀏覽器訪問http://127.0.0.1:8000/test/瀏覽器

瀏覽器正常顯示：函數

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類型