[Django高階之forms元件]

劉較瘦丫 發表於 2021-05-31
Django

[Django高階之forms元件]

forms元件之校驗欄位

# 第一步:定義一個類,繼承forms.Form
# 第二步:在類中寫欄位,要校驗的欄位,欄位屬性就是校驗規則
# 第三步:例項化得到一個Form物件,把要校驗的資料傳入
# 第四步:呼叫 物件.is_valid()校驗,校驗通過就是True
		可以判斷是否符合定義的欄位條件	
    
# 第五步:校驗通過有 物件.cleaned_data   
	獲取符合校驗規則的資料

# 第六步:校驗不通過 物件.errors
	獲取不符合校驗的欄位、以及錯誤資訊

前戲
	寫一個註冊頁面獲取使用者的使用者名稱和密碼
    傳送到後端之後在後端完成對使用者名稱和密碼的資料校驗
    
    	1.使用者名稱裡面不能含有JPZ
        2.密碼不能為空
        
    將提示資訊渲染到前端頁面

    
1.前端頁面標籤書寫
2.前端頁面資訊展示
3.後端資料校驗


forms元件可以一條龍服務 幫你完成上面的三件事情
	1.渲染標籤
    2.校驗資料
    3.展示資訊

img

forms元件校驗資料

1、物件 .is_valid()

2、物件 .cleaned_data

3、物件 .errors

# forms程式碼書寫

from django import forms

class MyForm(forms.Form):
    
    # username欄位最少不能少於3位 最多不能超過8位
    username = forms.CharField(max_length=8,min_length=3)
    
    # password欄位最大值不能超過699
    password = forms.IntegerField(max_value=699)
    
    # email欄位必須符合郵箱格式
    email = forms.EmailField()
    
    
    
# 校驗資料
from app01 import views
# 1.類加括號 傳入字典即可
	form_obj = views.MyForm({'username':'jason','password':'123','email':'嘿嘿嘿'})
    
# 2.判斷資料是否合法(只有全部合法結果才為True)
	form_obj.is_valid()
	False
    
# 3.檢視所有合法的資料
	form_obj.cleaned_data
	{'username': 'jason', 'password': 123}
    
# 4.檢視所有不合法的資料及原因
	form_obj.errors
	{'email': ['Enter a valid email address.']}
    
"""
校驗資料可以多傳 但是不能少傳(預設必填)
"""

校驗資料可以多傳 但是不能少傳(預設必填)

forms元件渲染標籤

def register(request):
    if request.method == 'GET':
        # GET請求沒有資料,需要生成一個空form物件
        # 這個form跟下面沒有關係,是get請求過來的得到一個空form
        register_form = RegisterFrom()
        # 傳到前端頁面後,通過form進行渲染
        return render(request, 'register.html', {'form': register_form})
    else:
        register_form = RegisterFrom(request.POST)

        if register_form.is_valid():
            print('效驗通過')
            print(register_form.cleaned_data)
            register_form.cleaned_data.pop('re_password')
            models.User.objects.create(**register_form.cleaned_data)
        else:
            print('效驗不通過')
            print(register_form.errors)

        return render(request,'register.html')

渲染方式一

可擴充套件性強,但是需要書寫的程式碼太多,一般情況下不用

 <h2>通過form自動渲染一</h2>
<form action="" method="post">
     <p>使用者名稱 {{ form.name }}</p>   
     <p>密碼 {{ form.password }}</p>    
    <p>確認密碼 {{ form.re_password }}</p>    
    <p>郵箱 {{ form.email }}</p>    
<input type="submit" value="提交"></form>

渲染方式二

推薦使用,程式碼書寫簡單,並且可擴充套件性強

<h2>通過form自動渲染二(基本用這種)</h2>

<form action="" method="post">
    {% for item in form %}
        <p>{{ item.label }}{{ item }}</p>                    
    {% endfor %}
<input type="submit" value="提交"><span style="color: red">{{ error }}</span>

</form>

渲染方式三

程式碼書寫極少,封裝程度太高,不便於後續的擴充套件,一般情況下只在本地測試使用

<h2>通過form自動渲染三</h2>
<form action="" method="post">
    {{ form.as_p }}
    {#    {{ form.as_table }}#}
    {#    {{ form.as_ul }}#}

</form>

img

注意:#forms元件無法渲染提交按鈕和form標籤都需要你自己編寫

img

forms元件展示提示資訊

後端程式碼書寫views.py

# 後端views中定義form類:

from django import forms
# forms程式碼書寫
class Myform(forms.Form):
    # 最多8位 最少3位
    username = forms.CharField(max_length=8,min_length=3,label='使用者名稱',
                               error_messages={  
                                   # 自定義錯誤資訊
                                   'max_length':'使用者名稱最多8位',
                                   'min_length':'使用者名稱最少3位',
                                   'required':'使用者名稱不能為空',
                               },
                               widget=widgets.TextInput(attrs={'class':'form-control'}))
    						# 指定欄位型別				
        )
        
    # 最多666位
    password = forms.IntegerField(max_value=666,label='密碼',
                                  error_messages={  
                                      # 自定義錯誤資訊
                                      'max_length': '密碼最多8位',
                                      'min_length': '密碼最少3位',
                                      'required': '密碼不能為空'
                                  },
                                   widget=widgets.PasswordInput(attrs={'class':'form-control'}))					# 指定欄位型別為 password
                                 )
    confirm_password = forms.IntegerField(max_value=666, label='確認密碼',
                                  error_messages={  
                                      # 自定義錯誤資訊
                                      'max_length': '確認密碼最多8位',
                                      'min_length': '確認密碼最少3位',
                                      'required': '確認密碼不能為空'
                                  })
    # 必須符合郵箱格式
    email = forms.EmailField(label='郵箱',
                             error_messages={  # 自定義錯誤資訊
                                'invalid':'郵箱格式不正確',
                                 'required': '郵箱不能為空',
                             })
    
 --------------------------------------------------------------------
 
# views檢視函式處理部分:
    
    def login(request):
    # 1、先生成一個物件
    form_obj = Myform()
    # 2、判斷請求方式
    if request.method == 'POST':
        
          # 獲取使用者資料
        # request.POST  # 可以直接看成是一個字典
        # 校驗使用者資料
        # MyForm()  # forms元件校驗資料剛好需要傳入一個字典
        '''上述兩步合一步'''
        
        # 3、校驗資料  於上面物件名字必須一致
        form_obj = Myform(request.POST)
        # 4、判斷資料是否合法
        if form_obj.is_valid():
            # 5、合法的話
            return HttpResponse('登入成功')
   
	# 2.將該物件傳遞給html頁面
    return render(request,'login.html',locals())

前端程式碼書寫login.html

<!DOCTYPE html>
<html lang="en">
<head>
    <meta charset="UTF-8">
    <title>Title</title>
    <script src="https://cdn.bootcdn.net/ajax/libs/jquery/3.6.0/jquery.min.js"></script>
    <script src="https://cdn.bootcdn.net/ajax/libs/twitter-bootstrap/3.4.1/js/bootstrap.min.js"></script>
    <link href="https://cdn.bootcdn.net/ajax/libs/twitter-bootstrap/3.4.1/css/bootstrap.min.css" rel="stylesheet">
</head>
<body>
<form action="" method="post" novalidate>
# 取消瀏覽器校驗 novalidate
	
  
    {% for form in form_obj %}
        <p>{{ form.label }}:{{ form }}
        <span style="color: red">{{ form.errors.0 }}</span>
        </p>
    {% endfor %}

    <button class="btn btn-info">提交</button>



</form>
</body>
</html>

img

forms元件常用引數

class Ret(Form):
    name = forms.CharField(max_length=10, min_length=2, label='使用者名稱',
                           error_messages={
                               'required': '該欄位不能為空',
                               'invalid': '格式錯誤', 
                               'max_length': '太長',
                               'min_length': '太短'},
                           widget=widgets.TextInput(attrs={'class':'form-control'}))


max_length			最大範圍
min_length			最小範圍
label				欄位文字內容
required			欄位是否必填 預設是True
error_messages		 定義提示資訊
widget				定義欄位型別和屬性
validators			額外的校驗功能(一般都是正則)
initial			    設定預設值

img

forms元件鉤子函式

除了上面兩種方式,我們還可以在Form類中定義鉤子函式,來實現自定義的驗證功能。

區域性鉤子:

我們在Fom類中定義 clean_欄位名() 方法,就能夠實現對特定欄位進行校驗。

全域性鉤子:

我們在Fom類中定義 clean() 方法,就能夠實現對欄位進行全域性校驗。

提供更加複雜的與業務相關的校驗功能
鉤子函式其實就在書寫forms類的過程中定義方法

'''鉤子函式都是在資料校驗的最後一個環節執行'''
--------------------------------------------------------------------------------------

區域性鉤子(單個欄位校驗使用區域性)

	# 校驗當前使用者名稱是否已存在
    def clean_username(self):
        # 獲取使用者名稱
        username = self.cleaned_data.get('username')
        # 查詢資料庫並判斷
        if username == 'jason':
            # 提示使用者名稱已存在
            self.add_error('username','使用者名稱已存在')
        return username

 -----------------------------------------------------------------------------------   
    
全域性鉤子(多個欄位校驗使用全域性)
	# 校驗密碼與確認密碼是否一致
    def clean(self):
        # 獲取密碼 與 確認密碼
        password = self.cleaned_data.get('password')
        confirm_password = self.cleaned_data.get('confirm_password')
        if not password == confirm_password:
            self.add_error('confirm_password','兩次密碼不一致')
        return self.cleaned_data

img

常用欄位與外掛

建立Form類時,主要涉及到 【欄位】 和 【外掛】,欄位用於對使用者請求資料的驗證,外掛用於自動生成HTML;

initial

初始值,input框裡面的初始值。

class LoginForm(forms.Form):
    username = forms.CharField(
        min_length=8,
        label="使用者名稱",
        initial="張三"  # 設定預設值
    )
    pwd = forms.CharField(min_length=6, label="密碼")

error_messages

重寫錯誤資訊。

class LoginForm(forms.Form):
    username = forms.CharField(
        min_length=8,
        label="使用者名稱",
        initial="張三",
        error_messages={
            "required": "不能為空",
            "invalid": "格式錯誤",
            "min_length": "使用者名稱最短8位"
        }
    )
    pwd = forms.CharField(min_length=6, label="密碼")

password

class LoginForm(forms.Form):
    ...
    pwd = forms.CharField(
        min_length=6,
        label="密碼",
        widget=forms.widgets.PasswordInput(attrs={'class': 'c1'}, render_value=True)
    )

radioSelect

單radio值為字串

class LoginForm(forms.Form):
    username = forms.CharField(
        min_length=8,
        label="使用者名稱",
        initial="張三",
        error_messages={
            "required": "不能為空",
            "invalid": "格式錯誤",
            "min_length": "使用者名稱最短8位"
        }
    )
    pwd = forms.CharField(min_length=6, label="密碼")
    gender = forms.fields.ChoiceField(
        choices=((1, "男"), (2, "女"), (3, "保密")),
        label="性別",
        initial=3,
        widget=forms.widgets.RadioSelect()
    )

單選Select

class LoginForm(forms.Form):
    ...
    hobby = forms.ChoiceField(
        choices=((1, "籃球"), (2, "足球"), (3, "雙色球"), ),
        label="愛好",
        initial=3,
        widget=forms.widgets.Select()
    )

多選Select

class LoginForm(forms.Form):
    ...
    hobby = forms.MultipleChoiceField(
        choices=((1, "籃球"), (2, "足球"), (3, "雙色球"), ),
        label="愛好",
        initial=[1, 3],
        widget=forms.widgets.SelectMultiple()
    )

單選checkbox

class LoginForm(forms.Form):
    ...
    keep = forms.ChoiceField(
        label="是否記住密碼",
        initial="checked",
        widget=forms.widgets.CheckboxInput()
    )

多選checkbox

class LoginForm(forms.Form):
    ...
    hobby = forms.MultipleChoiceField(
        choices=((1, "籃球"), (2, "足球"), (3, "雙色球"),),
        label="愛好",
        initial=[1, 3],
        widget=forms.widgets.CheckboxSelectMultiple()
    )

RegexValidator驗證器

from django.forms import Form
from django.forms import widgets
from django.forms import fields
from django.core.validators import RegexValidator
 
class MyForm(Form):
    user = fields.CharField(
        validators=[RegexValidator(r'^[0-9]+$', '請輸入數字'), RegexValidator(r'^159[0-9]+$', '數字必須以159開頭')],
    )

choice欄位注意事項

在使用選擇標籤時,需要注意choices的選項可以配置從資料庫中獲取,但是由於是靜態欄位 獲取的值無法實時更新,需要重寫構造方法從而實現choice實時更新。

方式一:

from django.forms import Form
from django.forms import widgets
from django.forms import fields

 
class MyForm(Form):
 
    user = fields.ChoiceField(
        # choices=((1, '上海'), (2, '北京'),),
        initial=2,
        widget=widgets.Select
    )
 
    def __init__(self, *args, **kwargs):
        super(MyForm,self).__init__(*args, **kwargs)
        # self.fields['user'].choices = ((1, '上海'), (2, '北京'),)
        # 或
        self.fields['user'].choices = models.Classes.objects.all().values_list('id','caption')

方式二:

from django import forms
from django.forms import fields
from django.forms import models as form_model

 
class FInfo(forms.Form):
    authors = form_model.ModelMultipleChoiceField(queryset=models.NNewType.objects.all())  # 多選
    # authors = form_model.ModelChoiceField(queryset=models.NNewType.objects.all())  # 單選

img