Django-form表單

Django-form表單

在Django中使用forms 構建表單

使用Django提供得forms 表單模塊構建得表單結構,能夠在數據出現錯誤,返回頁面中仍能夠保留以前輸入得數據,一樣能夠限制字段條件;

在Django中經過forms構建一個表單

1. 在app 包路徑 建立一個forms_to.py 用於定義類:html

from django import forms
from django.forms import widgets

# 經過定義一個 類 來設置全部的標籤類型
# IntegerField 只容許爲數字
# CharField    爲字符串
# EmailField   格式須要爲 Email

class RegForm(forms.Form):
    # 長度最多 12 字符,最少 6 字符;
    # 當超出該字符時,瀏覽器會阻止多餘字符得輸入;
    # 當少於這些字符時,會返回 min_length 得提示 (可自定義)
    username = forms.CharField(
        max_length=12, 
        min_length=6, 
        error_messages={"required": "該字段不能爲空",
                        "min_length":"最少爲6字符",
                        "max_length":"最多爲12個字符"})

    password = forms.IntegerField(
        # widgets.PasswordInput() 用於渲染密碼 加密
        widget=widgets.PasswordInput(),
        error_messages={"invalid": "格式錯誤,必須爲數字"}
    )
    
    repeat_password = forms.CharField(
        # 能夠添加 標籤屬性
        widget=widgets.PasswordInput(attrs={"class": "pwd"})
        error_messages={"required": "該字段不能爲空",}
    )

    email = forms.EmailField()

    umout = forms.CharField(
        # 用戶 渲染 select 標籤下拉框
        widget=widgets.Select(choices=((1, "上海"), (2, "北京")))
    )

2. 在views.py中引入forms_to.py 並實例化該類:前端

from django.shortcuts import render,redirect,HttpResponse

# 導入自定義的 forms_to form表單類
from app01 import forms_to

def reg(request):
    # 若是請求方式爲 POST 獲取前端傳入的 值
    if request.method == "POST":

        # 將傳入的值,放入到 RegForm 進行實例化
        regForm = forms_to.RegForm(request.POST)

        # 傳入值的實例化數據,有一個is_valid 屬性;當全部的驗證都經過的時候返回 True
        if regForm.is_valid():
        
            # 所有正確 數據 依照字典的形式 都存放在 regForm.cleaned_data 裏面
            
            print("全對:", regForm.cleaned_data)
            # {'email': 'asdfsdf@qq.com', 'umout': '1', 'password': 'asdfasdf', 'username': 'asdfas', 'repeat_password': 'safdsaf'}
            
            username = regForm.cleaned_data.get("username")
            password = regForm.cleaned_data.get("password")
            # 將獲取的數據存入數據庫便可
            
        else:
            # 只要有錯誤,就會走 else
            # 並在 regForm.errors 存放 錯誤得部分
            # 在regForm.cleaned_data 存放 正確得部分
            
            # print(regForm.errors.get("username")[0])

            # 存放 錯誤的信息
            print(regForm.cleaned_data)
        return render(request, "reg.html", {"regForm": regForm})

    # 實例化 RegForm 類 並將 實例化的結果傳給 前端渲染
    regForm=forms_to.RegForm()

    return render(request, "reg.html", {"regForm": regForm})

3. 在views.py中引入forms_to.py 並實例化該類:python

<!DOCTYPE html>
<html lang="en">
<head>
    <meta charset="UTF-8">
    <title>Title</title>
    <style>
        .error{
            color: red;
        }
    </style>
</head>
<body>

    <form action="/reg/" method="post">
        {% csrf_token %}
        {# 模板中使用regForm 獲取實例化得方法 #}              {# regForm.errors.username.0 獲取傳入錯誤得第一個錯誤 #}
        <p>姓名{{ regForm.username }}<span class="error">{{ regForm.errors.username.0 }}</span></p>
        <p>密碼{{ regForm.password }}<span class="error">{{ regForm.errors.password.0 }}</span></p>
        <p>確認密碼{{ regForm.repeat_password }}<span class="error">{{ regForm.errors.repeat_password.0 }}</span></p>
        <p>郵箱{{ regForm.email }}<span class="error">{{ regForm.errors.email.0 }}</span></p>
        <p>城市{{ regForm.umout }}</p>
        <p><input type="submit" value="提交"></p>
    </form>
    
</body>
</html>

form 組建經常使用字段

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

2、Django經常使用選擇插件

# 單radio,值爲字符串
# user = fields.CharField(
#     initial=2,
#     widget=widgets.RadioSelect(choices=((1,'上海'),(2,'北京'),))
# )
 
# 單radio,值爲字符串
# user = fields.ChoiceField(
#     choices=((1, '上海'), (2, '北京'),),
#     initial=2,
#     widget=widgets.RadioSelect
# )
 
# 單select,值爲字符串
# user = fields.CharField(
#     initial=2,
#     widget=widgets.Select(choices=((1,'上海'),(2,'北京'),))
# )
 
# 單select,值爲字符串
# user = fields.ChoiceField(
#     choices=((1, '上海'), (2, '北京'),),
#     initial=2,
#     widget=widgets.Select
# )
 
# 多選select,值爲列表
# user = fields.MultipleChoiceField(
#     choices=((1,'上海'),(2,'北京'),),
#     initial=[1,],
#     widget=widgets.SelectMultiple
# )
 
 
# 單checkbox
# user = fields.CharField(
#     widget=widgets.CheckboxInput()
# )
 
 
# 多選checkbox,值爲列表
# user = fields.MultipleChoiceField(
#     initial=[2, ],
#     choices=((1, '上海'), (2, '北京'),),
#     widget=widgets.CheckboxSelectMultiple
# )
相關文章
相關標籤/搜索