Django-form表單

時間 2019-11-26

標籤 django form 表單欄目 Python 简体版

原文原文鏈接

構建一個表單

假設你想在你的網站上建立一個簡單的表單，以得到用戶的名字。你須要相似這樣的模板：前端

 
          <form  
          action 
          = 
          "/your-name/" 
          method= 
          "post" 
          > 
         
 
               
          <label  
          for 
          = 
          "your_name" 
          >Your  
          name 
          : </label> 
         
 
               
          <input id= 
          "your_name" 
          type= 
          "text" 
          name 
          = 
          "your_name" 
          > 
         
 
               
          <input type= 
          "submit" 
          value= 
          "OK" 
          > 
         
 
          </form> 
         

這是一個很是簡單的表單。實際應用中，一個表單可能包含幾十上百個字段，其中大部分須要預填充，並且咱們預料到用戶未來回編輯-提交幾回才能完成操做。python

咱們可能須要在表單提交以前，在瀏覽器端做一些驗證。咱們可能想使用很是複雜的字段，以容許用戶作相似從日曆中挑選日期這樣的事情，等等。正則表達式

這個時候，讓Django 來爲咱們完成大部分工做是很容易的。sql

回到頂部(go to top)

在Django 中構建一個表單

Form 類

咱們已經計劃好了咱們的 HTML 表單應該呈現的樣子。在Django 中，咱們的起始點是這裏：數據庫

 
          #forms.py 
         
          from 
          django import forms 
         
          class NameForm(forms.Form): 
         
          your_name = forms.CharField(label= 
          'Your name' 
          , max_length=100)

它定義一個Form 類，只帶有一個字段（your_name）。django

字段容許的最大長度經過max_length 定義。它完成兩件事情。首先，它在HTML 的<input> 上放置一個maxlength="100"（這樣瀏覽器將在第一時間阻止用戶輸入多於這個數目的字符）。它還意味着當Django 收到瀏覽器發送過來的表單時，它將驗證數據的長度。瀏覽器

Form 的實例具備一個is_valid() 方法，它爲全部的字段運行驗證的程序。當調用這個方法時，若是全部的字段都包含合法的數據，它將：app

返回True
將表單的數據放到cleaned_data屬性中。

完整的表單，第一次渲染時，看上去將像：ide

1 2	`<label` `for` `=` `"your_name"` `>Your` `name` `: </label>` `<input id=` `"your_name"` `type=` `"text"` `name` `=` `"your_name"` `maxlength=` `"100"` `>`

注意它不包含 <form> 標籤和提交按鈕。咱們必須本身在模板中提供它們。

視圖

發送給Django 網站的表單數據經過一個視圖處理，通常和發佈這個表單的是同一個視圖。這容許咱們重用一些相同的邏輯。

當處理表單時，咱們須要在視圖中實例化它：

#views.py

from django.shortcuts import render
from django.http import HttpResponseRedirect

from .forms import NameForm

def get_name(request):
    # if this is a POST request we need to process the form data
    if request.method == 'POST':
        # create a form instance and populate it with data from the request:
        form = NameForm(request.POST)
        # check whether it's valid:
        if form.is_valid():
            # process the data in form.cleaned_data as required
            # ...
            # redirect to a new URL:
            return HttpResponseRedirect('/thanks/')

    # if a GET (or any other method) we'll create a blank form
    else:
        form = NameForm()

    return render(request, 'name.html', {'form': form})

若是訪問視圖的是一個GET 請求，它將建立一個空的表單實例並將它放置到要渲染的模板的上下文中。這是咱們在第一個訪問該URL 時預期發生的狀況。

若是表單的提交使用POST 請求，那麼視圖將再次建立一個表單實例並使用請求中的數據填充它：form = NameForm(request.POST)。這叫作」綁定數據至表單「（它如今是一個綁定的表單）。

咱們調用表單的is_valid()方法；若是它不爲True，咱們將帶着這個表單返回到模板。這時表單再也不爲空（未綁定），因此HTML 表單將用以前提交的數據填充，而後能夠根據要求編輯並改正它。

若是is_valid()爲True，咱們將可以在cleaned_data 屬性中找到全部合法的表單數據。在發送HTTP 重定向給瀏覽器告訴它下一步的去向以前，咱們能夠用這個數據來更新數據庫或者作其它處理。

模板

咱們不須要在name.html 模板中作不少工做。最簡單的例子是：

 
          <form  
          action 
          = 
          "/your-name/" 
          method= 
          "post" 
          > 
         
          {% csrf_token %} 
         
          {{ form }} 
         
          <input type= 
          "submit" 
          value= 
          "Submit" 
          /> 
         
          </form>

根據{{ form }}，全部的表單字段和它們的屬性將經過Django 的模板語言拆分紅HTML 標記。

注：Django 原生支持一個簡單易用的跨站請求僞造的防禦。當提交一個啓用CSRF 防禦的POST 表單時，你必須使用上面例子中的csrf_token 模板標籤。

如今咱們有了一個能夠工做的網頁表單，它經過Django Form 描述、經過視圖處理並渲染成一個HTML <form>。

若是咱們自定義的驗證提示等，當咱們在前端頁面使用時：

 <form action="/blog/backend/updateArticle/p/{{ nid }}" method="post" >
        <div>
            <label for="title">標題：</label>
            <p>{{ article_form.title }}</p>
        </div>
        <div>
            <label for="title">內容：</label>
            <p>
                {{ article_form.content }}

            </p>

        </div>
        <p><input type="submit" value="提交"></p>


    </form>

若是出現如下錯誤提示時：

(index):1 An invalid form control with name='content' is not focusable.

咱們須要在加上 novalidate

<form action="/blog/backend/updateArticle/p/{{ nid }}" method="post" novalidate>

回到頂部(go to top)

Django Form 類詳解

綁定的和未綁定的表單實例

綁定的和未綁定的表單之間的區別很是重要：

未綁定的表單沒有關聯的數據。當渲染給用戶時，它將爲空或包含默認的值。
綁定的表單具備提交的數據，所以能夠用來檢驗數據是否合法。若是渲染一個不合法的綁定的表單，它將包含內聯的錯誤信息，告訴用戶如何糾正數據。

字段詳解

考慮一個比上面的迷你示例更有用的一個表單，咱們完成一個更加有用的註冊表單：

#forms.py

from django import forms

class RegisterForm(forms.Form):
    username = forms.CharField(max_length=100,
                               error_messages={"min_length":"最短爲5個字符","required":"該字段不能爲空"},
                               )
    password = forms.CharField(max_length=100,
                               widget=widgets.PasswordInput(attrs={"placeholder":"password"})
                                )
    
    telephone=forms.IntegerField()
    email = forms.EmailField()
    is_married = forms.BooleanField(required=False)

ChoiceField是下拉框類型

若是直接設置此字段，更新操做後，下拉框並不會更新，須要重啓django程序，由於直接在類中定義的靜態字段，只會執行一次，即查詢顯示操做，在編譯時就已經執行完畢，

爲了讓下拉框的數據實時同步，咱們須要重寫構造方法

    1. 班級管理
        class ClassForm(Form):
            caption = fields.CharField(error_messages={'required':'班級名稱不能爲空'})
            # headmaster = fields.ChoiceField(choices=[(1,'娜娜',)])  這樣寫沒法實時更新
            headmaster_id = fields.ChoiceField(choices=models.UserInfo.objects.filter(ut_id=2).values_list('id','username'))

        def class_add(request):
            if request.method == 'GET':
                form = ClassForm()
                return render(request,'class_add.html',{'form':form})
            else:
                form = ClassForm(data=request.POST)
                if not form.is_valid():
                    return render(request, 'class_add.html', {'form': form})
                models.ClassList.objects.create(**form.cleaned_data)
                return redirect('/class_list/')
    
    
        1. headmaster_id
        2. 數據源沒法實施更新，重寫構造方法
            方式一（推薦）：
                class ClassForm(Form):
                    caption = fields.CharField(error_messages={'required':'班級名稱不能爲空'})
                    # headmaster = fields.ChoiceField(choices=[(1,'娜娜',)])
                    headmaster_id = fields.ChoiceField(choices=[])

                    def __init__(self,*args,**kwargs):
                        super().__init__(*args,**kwargs)
                        self.fields['headmaster_id'].choices = models.UserInfo.objects.filter(ut_id=2).values_list('id','username')

            
            方式二：
            
                from django.forms.models import ModelChoiceField
                class ClassForm(Form):
                    caption = fields.CharField(error_messages={'required':'班級名稱不能爲空'})
                    # headmaster = fields.ChoiceField(choices=[(1,'娜娜',)])
                    headmaster_id = ModelChoiceField(queryset=models.UserInfo.objects.filter(ut_id=2))

Widgets

每一個表單字段都有一個對應的Widget 類，它對應一個HTML 表單Widget，例如<input type="text">。

在大部分狀況下，字段都具備一個合理的默認Widget。例如，默認狀況下，CharField 具備一個TextInput Widget，它在HTML 中生成一個<input type="text">。

字段的數據

無論表單提交的是什麼數據，一旦經過調用is_valid() 成功驗證（is_valid() 返回True），驗證後的表單數據將位於form.cleaned_data 字典中。這些數據已經爲你轉換好爲Python 的類型。

注：此時，你依然能夠從request.POST 中直接訪問到未驗證的數據，可是訪問驗證後的數據更好一些。

在上面的聯繫表單示例中，is_married將是一個布爾值。相似地，IntegerField 和FloatField 字段分別將值轉換爲Python 的int 和float。

form的字段能夠定義正則表達式

from django.core.validators import RegexValidator

password = fields.CharField(
    required=True,
    min_length=3,
    max_length=18,
    error_messages={
        'required': '密碼不能爲空',
        'min_length': '密碼長度不能小於3',
        'max_length': '密碼長度不能大於18',
        'invalid': '密碼格式錯誤',  #若是沒寫這個，則格式不對時顯示下面的‘只能是數字’
    },
    validators=[RegexValidator('\d+','只能是數字') ]
)

主動向form中添加錯誤信息

# form.add_error('password','用戶名或密碼錯誤')
form.add_error('password',ValidationError('用戶名或密碼錯誤'))

form初始化填寫input裏的默認值

def edit_teacher(request,nid):
    obj = models.UserInfo.objects.filter(id=nid,ut_id=1).first()
    if not obj:
        return redirect('/teachers/')

    if request.method == "GET":
        # 顯示input，而且將數據庫中的默認值填寫到input框中
        form = TeacherForm(initial={'username':obj.username,'password':obj.password,'email':obj.email})
        return render(request,'edit_teacher.html',{'form':form})
    else:
        form = TeacherForm(data=request.POST)
        if form.is_valid():
            # 校驗成功
            models.UserInfo.objects.filter(id=nid).update(**form.cleaned_data)
            return redirect('/teachers/')
        return render(request,'edit_teacher.html',{'form':form})

鉤子函數

此處拿登錄驗證爲例

from app01 import models

　from django.core.exceptions import ValidationError

#
# def index(request):
#
#     all_teacher_list=models.Teacher.objects.all()
#
#     return render(request,"index.html",locals())
#
# # def index(request):
# #     is_login=request.COOKIES.get("is_login",None)
# #     if is_login:
# #         username=request.COOKIES.get("username")
# #         return render(request, "index.html",locals())
# #     else:
# #         return redirect("/login/")
#
#
#
#
# def delTeacher(request,tid):
#
#     models.Teacher.objects.filter(tid=tid).delete()
#
#     return redirect("/index/")
#

class LoginForm(Form):
    username = fields.CharField(
        required=True,
        min_length=3,
        max_length=18,
        error_messages={
            'required': '用戶不能爲空',
            'min_length': '用戶長度不能小於3',
            'max_length': '用戶長度不能大於18',
        }
    )
    password = fields.CharField(
        required=True,
        min_length=3,
        max_length=18,
        error_messages={
            'required': '密碼不能爲空',
            'min_length': '密碼長度不能小於3',
            'max_length': '密碼長度不能大於18',
            'invalid': '密碼格式錯誤',
        },
        validators=[RegexValidator('\d+','只能是數字') ]
    )
    
    def clean_username(self):    #這個就是鉤子函數，爲哪一個字段寫，函數名就必須爲clean_字段名 # ...form驗證username時，若經過了正則驗證，則會執行此函數，下面的函數會判斷數據庫中是否有這個用戶名
         若是沒有則不會再進行其餘字段的驗證，並會報錯提示：用戶名不存在

        user = self.cleaned_data['username']
        is_exsit = models.UserInfo.objects.filter(username=user).count()
        if not is_exsit:
            raise ValidationError('用戶名不存在')  
        return user

注意：
　　必須有返回值
　　只能拿本身當前字段值
　　raise ValidationError('xxx')

回到頂部(go to top)

使用表單模板

你須要作的就是將表單實例放進模板的上下文。若是你的表單在Context 中叫作form，那麼{{ form }}將正確地渲染它的<label> 和 <input>元素。

表單渲染的選項

對於<label>/<input> 對，還有幾個輸出選項：

{{ form.as_table }} 以表格的形式將它們渲染在<tr> 標籤中
{{ form.as_p }} 將它們渲染在<p> 標籤中
{{ form.as_ul }} 將它們渲染在<li> 標籤中

注意，你必須本身提供<table> 或<ul> 元素。

{{ form.as_p }}會渲染以下：

<form action="">
    <p>
        <label for="id_username">Username:</label>
        <input id="id_username" maxlength="100" name="username" type="text" required="">
    </p>
 
 
    <p>
        <label for="id_password">Password:</label>
        <input id="id_password" maxlength="100" name="password" placeholder="password" type="password" required="">
    </p>
 
 
    <p>
        <label for="id_telephone">Telephone:</label> <input id="id_telephone" name="telephone" type="number" required="">
    </p>
 
 
    <p>
        <label for="id_email">Email:</label> <input id="id_email" name="email" type="email" required="">
    </p>
 
 
    <p>
        <label for="id_is_married">Is married:</label> <input id="id_is_married" name="is_married" type="checkbox">
    </p>
 
 
    <input type="submit" value="註冊">
</form>

View Code

手工渲染字段

咱們沒有必要非要讓Django 來分拆表單的字段；若是咱們喜歡，咱們能夠手工來作（例如，這樣容許從新對字段排序）。每一個字段都是表單的一個屬性，可使用{{ form.name_of_field }} 訪問，並將在Django 模板中正確地渲染。例如：

 
          < 
          div 
          class="fieldWrapper"> 
         
          {{ form.Username.errors }} 
         
          {{ form.Username.label_tag }} 
         
          {{ form.Username }} 
         
          </ 
          div 
          >

渲染表單的錯誤信息

一、

 
          registerForm=RegisterForm(request.POST) 
         
          print(type(registerForm.errors),"----------")#< 
          class 
          'django.forms.utils.ErrorDict'> 
         
          print(type(registerForm.errors["username"]),"----------")#< 
          class 
          'django.forms.utils.ErrorList'>

二、

使用{{ form.name_of_field.errors }} 顯示錶單錯誤的一個清單，並渲染成一個ul。看上去可能像：

 
          < 
          ul 
          class="errorlist"> 
         
 
               
          < 
          li 
          >Sender is required.</ 
          li 
          > 
         
 
          </ 
          ul 
          > 
         

回到頂部(go to top)

Form表單例子

相關標籤/搜索

每日一句

每一个你不满意的现在，都有一个你没有努力的曾经。