Django 之 form表單


Django中的Form表單

  1、背景

    平時我們在書寫form表單時,經常都是手動的去寫一些input標簽,讓用戶輸入一些功能,進行一些校驗的判斷,等等。Django中的form表單就能夠幫我們去實現這些功能,比較便捷。

  2、Django form表單的功能

      1、生成頁面可執行的HTML標簽

      2、對應戶的數據進行校驗

      3、保留上次輸入的內容

  3、先用普通方式手寫一個注冊功能

    1、views.py文件中

# 注冊
def register(request):
    error_msg = ""            # 剛進頁面的時候,用戶名還為空,此時錯誤信息先設置成空
    if request.method == "POST":
        username = request.POST.get("name")
        pwd = request.POST.get("pwd")
        # 對注冊信息做校驗
        if len(username) < 6:
            # 用戶長度小於6位
            error_msg = "用戶名長度不能小於6位"
        else:
            # 將用戶名和密碼存到數據庫
            return HttpResponse("注冊成功")
    return render(request, "register.html", {"error_msg": error_msg})

    2、register.html文件中

<!DOCTYPE html>
<html lang="en">
<head>
    <meta charset="UTF-8">
    <title>注冊頁面</title>
</head>
<body>
<form action="/reg/" method="post">
    {% csrf_token %}
    <p>
        用戶名:
        <input type="text" name="name">
    </p>
    <p>
        密碼:
        <input type="password" name="pwd">
    </p>
    <p>
        <input type="submit" value="注冊">
        <p style="color: red">{{ error_msg }}</p>
    </p>
</form>
</body>
</html>

  4、用form表單組件實現功能

    1、views.py文件中

      1、先定義一個RegForm類

from django import forms           # 導入forms 模塊

# 按照Django form組件的要求自己寫一個類
class RegForm(forms.Form):
    name = forms.CharField(label="用戶名")      # 會給name前邊生成一個lable標簽
    pwd = forms.CharField(label="密碼")        # 會給pwd前邊生成一個lable標簽

      2、寫一個視圖函數

# 使用form組件實現注冊方式
def register2(request):
    form_obj = RegForm()         # 實例化一個對象
    if request.method == "POST":
        # 實例化form對象的時候,把post提交過來的數據直接傳進去
        form_obj = RegForm(request.POST)
        # 調用form_obj校驗數據的方法
        if form_obj.is_valid():
            return HttpResponse("注冊成功")
    return render(request, "register2.html", {"form_obj": form_obj})    

    2、register2.html文件中

<!DOCTYPE html>
<html lang="zh-CN">
<head>
    <meta http-equiv="content-Type" charset="UTF-8">
    <meta http-equiv="x-ua-compatible" content="IE=edge">
    <meta name="viewport" content="width=device-width, initial-scale=1">
    <title>Title</title>
</head>
<body>

<form action="" method="post" novalidate autocomplete="off">  # novalidate 關閉django form表單自帶的一些校驗機制,  autocomplete='off' 可以讓輸入框輸入的數據保留下來,在刷新頁面的時候不被清空
    {% csrf_token %}
{#        {{ form_obj.as_p }}           對象.as_p 生成p標簽,里邊會自動成成input標簽#}
    <p> {{ form_obj.user.label }}       {# 生成 lable 標簽 #}
        {{ form_obj.user }}             {# 生成 user 的 input 標簽 #}
        <span style="color: red">{{ form_obj.user.errors.0 }}</span>   # form_obj.errors 是一個字典,通過.user拿到user這個鍵值對,
                                           # 再通過.error拿到一個django form 表單自動生成的<u>l標簽下的<li>標簽的錯誤信息,最后通過.0索引取到錯誤信息
</p> <p> {{ form_obj.pwd.label }} {{ form_obj.pwd }} <span style="color: red">{{ form_obj.pwd.errors.0 }}</span> </p> <p> {{ form_obj.re_pwd.label }} {{ form_obj.re_pwd }} <span style="color: red">{{ form_obj.re_pwd.errors.0 }}</span> </p

      form_obj.errors  類型  和 內容

    3、小結:

1、自動成成<pP標簽和<input>的方法:
   {{ form_obj.as_p}}        # 自動生成<p>標簽並且里邊如果有屬性會生成<input>標簽



   {{ form_obj.user.lable}}   # 單獨生成<lable>標簽
    {{form_obj_user}}   # 單獨生成一個輸入用戶名的<input> 標簽
2if request.method == 'POST':
        form_obj = RegForm(request.POST)

#  給實例化的對象獲取所有的POST請求的數據,這樣就可以通過對象.屬性拿值了
3
        if form_obj.is_valid():      # 通過is_valid方法,檢驗所有的POST請求提交的數據,如果有一個沒通過校驗,都無法將數據添加到cleaned_data中。
            # cleaned_data  是經過校驗的數據
            print(form_obj.cleaned_data)
# form_obj.cleaned_data  的數據類型是個字典
# <class 'dict'> {'user': '22w1236', 'pwd': '123456', 're_pwd': '123456', 'phone': '1333333333'} 這是所有校驗都通過后,cleaned_data字典中存的校驗信息

  5、常用字段與插件

    1、initial

      設置初始值,也就是默認值

       

class LoginForm(forms.Form):
    username = forms.CharField(
        min_length=8,   # 用戶名最小長度為8
        label="用戶名",
        initial="張三"  # 設置默認值
    )
    pwd = forms.CharField(min_length=6, label="密碼")  # 密碼最小長度為6

    2、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="密碼")

# 如果不滿足條件,就會按照錯誤類型,報出自定義的錯誤

    3、password

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

# widgets 是一個插件
#  widget=forms.widgets.PasswordInput()  將Input框的類型設置成password類型

    4、radioSelect

class LoginForm(forms.Form):
    gender = forms.fields.ChoiceField(
        choices=((1, ""), (2, ""), (3, "保密")),
        label="性別",
        initial=3,
        widget=forms.widgets.RadioSelect()
    )
#    gender = forms.fields.ChoiceField 先設置成ChoiceField 
#    通過插件widgests設置成單選框

    5、單選Select

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

# 通過widgest 插件 設置成單選下拉框

    6、多選Select

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

# 通過插件widgets.SelectMultiple 設置成 多選下拉框

    7、單選checkbox

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

# 設置成復選框格式的單選

    8、多選checkbox

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

# 設置成復選框的多選框
# 首先是 字段 = form.field.MultipleChoiceField
# 通過插件.CheckboxSelectMultiple 設置成復選框的多選框

    9、自定義初始化方法

     在使用選擇標簽的時候,也就是在指定有關於choices的那些選擇框,里邊的數據是可以從數據庫中獲取的,也就不需要手動去代碼中添加,而是通過 models.Classes.objects.all().values_list('id','caption')就能夠動態的將數據庫中的相關信息添加到選項框中,但是他只能獲取靜態的值,當數據庫中有新的數據更新進去的時候,就無法獲取(相對的,如果重啟一次服務也能獲取到),這時就需要自定義一個初始化方法。

  

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):          # 自定義一個__init__方法的初始化方法,通過調用父類的__iniy__方法,進行初始化實現動態更新
        super(MyForm,self).__init__(*args, **kwargs)
        # self.fields['user'].choices = ((1, '上海'), (2, '北京'),)
        #
        self.fields['user'].choices = models.Classes.objects.all().values_list('id','caption')    # 動態從數據庫中獲取值

  6、Django Form所有內置字段

Field
    required=True,               是否允許為空
    widget=None,                 HTML插件
    label=None,                  用於生成Label標簽或顯示內容
    initial=None,                初始值
    help_text='',                幫助信息(在標簽旁邊顯示)
    error_messages=None,         錯誤信息 {'required': '不能為空', 'invalid': '格式錯誤'}
    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類型

Django Form內置字段
內置字段

  7、校驗

    1、正則校驗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開頭')
], )

    2、ValidationError

from django.core.exceptions import ValidationError

    def clean_phone(self):
        value = self.cleaned_data.get('phone')
        if re.match(r'^1[3-9]\d{9}$',value):
            return value

        raise ValidationError('手機號不正經')

    3、局部鈎子函數校驗

 def clean_re_pwd(self):
        # 通過對象.cleaned_data.get(字段)獲取字段信息,且注意順序,確認密碼必須寫在密碼之后,不然會造成,校驗還沒完成就去獲取值,是獲取不到的
        pwd = self.cleaned_data.get('pwd')     
        re_pwd = self.cleaned_data.get('re_pwd')

        if pwd == re_pwd:
            return re_pwd
        raise ValidationError('兩次密碼不一致')        

    4、全局鈎子函數校驗

    def clean(self):
        pwd = self.cleaned_data.get('pwd')
        re_pwd = self.cleaned_data.get('re_pwd')

        if pwd == re_pwd:
            return self.cleaned_data
        self.add_error('re_pwd','兩次密碼不一致')
        raise ValidationError('兩次密碼不一致')

#  定義全局鈎子函數的時候,函數名必須是clean
#  全局鈎子的特點是,先對所有的字段進行一次校驗,然后再從校驗的結果中,進行二次校驗,返回一個cleaned_data
# 給校驗的字段添加提示的錯誤信息,方法是 對象.add_error('字段名稱','錯誤信息內容')

 

  

 

    

    

    

 

    


免責聲明!

本站轉載的文章為個人學習借鑒使用,本站對版權不負任何法律責任。如果侵犯了您的隱私權益,請聯系本站郵箱yoyou2525@163.com刪除。



 
粵ICP備18138465號   © 2018-2025 CODEPRJ.COM