[Django高階之forms元件]

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

[Django高階之forms元件]

forms元件之校驗欄位

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

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

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

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


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

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>

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

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>

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			    設定預設值

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

常用欄位與外掛

建立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())  # 單選

Django forms元件
2020-09-20
DjangoORM元件
[Django高階之批量插入資料、分頁器元件]
2021-05-29
Django元件
Django高階之-快取
2022-04-05
Django快取
forms元件
2024-03-28
ORM元件
高階元件
2018-09-15
元件
從高階函式--->高階元件
2018-05-20
函式元件
React 高階元件
2018-03-11
React元件
React高階元件
2020-12-27
React元件
Django 進階之 celery
2018-08-27
Django
React 進階(三) 高階元件
2019-03-18
React元件
React高階指南之高階元件
2018-08-18
React元件
React HOC（高階元件）
2019-05-22
React元件
React 高階應用 -- 高階元件 Heigher Order Component
2019-03-31
React元件
奇技淫巧 – Vue Mixins 高階元件與 Vue HOC 高階元件實踐
2019-01-02
Vue元件
奇技淫巧 - Vue Mixins 高階元件與 Vue HOC 高階元件實踐
2019-01-02
Vue元件
高階 Vue 元件模式 (8)
2018-10-28
Vue元件模式
高階 Vue 元件模式 (7)
2018-10-26
Vue元件模式
高階 vue 元件模式 4
2018-10-21
Vue元件模式
高階 vue 元件模式 2
2018-10-21
Vue元件模式
高階 vue 元件模式 6
2018-10-21
Vue元件模式
高階 vue 元件模式 1
2018-10-21
Vue元件模式
高階 Vue 元件模式 3
2018-10-21
Vue元件模式
React 高階元件介紹
2019-03-04
React元件
React高階元件初探(1)
2019-03-18
React元件
React高階元件的使用
2019-02-27
React元件
高階元件 + New Context API = ?
2018-10-15
元件ContextAPI
React高階元件精講
2018-09-14
React元件
React高階元件總結
2018-09-16
React元件
[譯] 深入 React 高階元件
2018-05-17
React元件
深入React高階元件(HOC)
2018-04-23
React元件
React中的高階元件
2021-01-15
React元件
Django高階程式設計之自定義Field實現多語言
2019-07-01
Django程式設計
vue元件詳解（五）——元件高階用法
2018-04-10
Vue元件
[譯]React高階話題之高階元件
2018-11-27
React元件
Django Forms元件,展示使用者輸入不合規的提示資訊,鉤子函式
2024-03-25
DjangoORM元件函式
深入理解 React 高階元件
2018-11-29
React元件
React 深入系列6：高階元件
2019-03-04
React元件
react 的高階元件再理解
2019-02-26
React元件

[Django高階之forms元件]

[Django高階之forms元件]

forms元件之校驗欄位

forms元件校驗資料

1、物件 .is_valid()

2、物件 .cleaned_data

3、物件 .errors

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

forms元件渲染標籤

渲染方式一

渲染方式二

渲染方式三

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

forms元件展示提示資訊

後端程式碼書寫views.py

前端程式碼書寫login.html

forms元件常用引數

forms元件鉤子函式

常用欄位與外掛

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

initial

error_messages

password

radioSelect

單選Select

多選Select

單選checkbox

多選checkbox

RegexValidator驗證器

choice欄位注意事項

相關文章

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

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