Python之路--Django--form組件與model form組件

時間  2019-11-10
標籤 python 之路 django form 組件 model 欄目 Python 简体版
原文   原文鏈接

1、form組件介紹

咱們以前在HTML頁面中利用form表單向後端提交數據時，都會寫一些獲取用戶輸入的標籤而且用form標籤把它們包起來。html

與此同時咱們在好多場景下都須要對用戶的輸入作校驗，好比校驗用戶是否輸入，輸入的長度和格式等正不正確。若是用戶輸入的內容有錯誤就須要在頁面上相應的位置顯示對應的錯誤信息.。前端

Django form組件就實現了上面所述的功能。git

總結一下，其實form組件的主要功能以下:正則表達式

  • 生成頁面可用的HTML標籤
  • 對用戶提交的數據進行校驗
  • 保留上次輸入內容

 

一、普通方式手寫註冊功能

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})

login.htmldjango

<!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>

 

二、使用form組件實現註冊功能

views.py

先定義好一個RegForm類：bootstrap

from django import forms # 按照Django form組件的要求本身寫一個類
class RegForm(forms.Form): name = forms.CharField(label="用戶名") pwd = forms.CharField(label="密碼")

再寫一個視圖函數：小程序

# 使用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})

login2.html後端

<!DOCTYPE html>
<html lang="en">
<head>
    <meta charset="UTF-8">
    <title>註冊2</title>
</head>
<body>
    <form action="/reg2/" method="post" novalidate autocomplete="off"> {% csrf_token %} <div>
            <label for="{{ form_obj.name.id_for_label }}">{{ form_obj.name.label }}</label> {{ form_obj.name }} {{ form_obj.name.errors.0 }} </div>
        <div>
            <label for="{{ form_obj.pwd.id_for_label }}">{{ form_obj.pwd.label }}</label> {{ form_obj.pwd }} {{ form_obj.pwd.errors.0 }} </div>
        <div>
            <input type="submit" value="註冊">
        </div>
    </form>
</body>
</html>

看網頁效果發現 也驗證了form的功能：
• 前端頁面是form類的對象生成的                                      -->生成HTML標籤功能
• 當用戶名和密碼輸入爲空或輸錯以後 頁面都會提示             -->用戶提交校驗功能
• 當用戶輸錯以後 再次輸入 上次的內容還保留在input框        -->保留上次輸入內容app

 

三、經常使用字段與插件

　　建立Form類時，主要涉及到 【字段】 和 【插件】，字段用於對用戶請求數據的驗證，插件用於自動生成HTML;

initial:

初始值，imput框裏面的初始值

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.fields.ChoiceField( choices=((1, "籃球"), (2, "足球"), (3, "雙色球"), ), label="愛好", initial=3, widget=forms.widgets.Select() )

 

多選Select

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

 

單選checkbox

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

 

多選checkbox

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

關於choice的注意事項：

在使用選擇標籤時，須要注意choices的選項能夠從數據庫中獲取，可是因爲是靜態字段 ***獲取的值沒法實時更新***，那麼須要自定義構造方法從而達到此目的。

方式一：

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

 

五、校驗

方式一：

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開頭')], )

方式二：

import re from django.forms import Form from django.forms import widgets from django.forms import fields from django.core.exceptions import ValidationError # 自定義驗證規則
def mobile_validate(value): mobile_re = re.compile(r'^(13[0-9]|15[012356789]|17[678]|18[0-9]|14[57])[0-9]{8}$') if not mobile_re.match(value): raise ValidationError('手機號碼格式錯誤') class PublishForm(Form): title = fields.CharField(max_length=20, min_length=5, error_messages={'required': '標題不能爲空', 'min_length': '標題最少爲5個字符', 'max_length': '標題最多爲20個字符'}, widget=widgets.TextInput(attrs={'class': "form-control", 'placeholder': '標題5-20個字符'})) # 使用自定義驗證規則
    phone = fields.CharField(validators=[mobile_validate, ], error_messages={'required': '手機不能爲空'}, widget=widgets.TextInput(attrs={'class': "form-control", 'placeholder': u'手機號碼'})) email = fields.EmailField(required=False, error_messages={'required': u'郵箱不能爲空','invalid': u'郵箱格式錯誤'}, widget=widgets.TextInput(attrs={'class': "form-control", 'placeholder': u'郵箱'}))

 

六、添加樣式 

可經過重寫form類的init方法來實現。

class LoginForm(forms.Form): username = forms.CharField( min_length=8, label="用戶名", initial="張三", error_messages={ "required": "不能爲空", "invalid": "格式錯誤", "min_length": "用戶名最短8位" } ... def __init__(self, *args, **kwargs): super(LoginForm, self).__init__(*args, **kwargs) for field in iter(self.fields): self.fields[field].widget.attrs.update({ 'class': 'form-control' }) 批量添加樣式

 

2、Django的model form組件

　　這是一個神奇的組件，經過名字咱們能夠看出來，這個組件的功能就是把model和form組合起來，

　　先來一個簡單的例子來看一下這個東西怎麼用：好比咱們的數據庫中有這樣一張學生表，字段有姓名，年齡，愛好，郵箱，電話，住址，註冊時間等等一大堆信息，如今讓你寫一個建立學生的頁面，你的後臺應該怎麼寫呢？首先咱們會在前端一個一個羅列出這些字段，讓用戶去填寫，而後咱們從後臺一個一個接收用戶的輸入，建立一個新的學生對象，保存其實，重點不是這些，而是合法性驗證，咱們須要在前端判斷用戶輸入是否合法，好比姓名必須在多少字符之內，電話號碼必須是多少位的數字，郵箱必須是郵箱的格式這些固然能夠一點一點手動寫限制，各類判斷，這毫無問題，除了麻煩咱們如今有個更優雅（之後在Python相關的內容裏，要多用「優雅」這個詞，而且養成習慣）的方法：ModelForm先來簡單的，生硬的把它用上，再來加驗證條件。

 

一、建立modelform

#首先導入ModelForm

from django.forms import ModelForm #在視圖函數中，定義一個類，好比就叫StudentList，這個類要繼承ModelForm，在這個類中再寫一個原類Meta（規定寫法，並注意首字母是大寫的） #在這個原類中，有如下屬性（部分）：

class StudentList(ModelForm): class Meta: model =Student #對應的Model中的類
        fields = "__all__" #字段，若是是__all__,就是表示列出全部的字段
        exclude = None #排除的字段
        #error_messages用法：
        error_messages = { 'name':{'required':"用戶名不能爲空",}, 'age':{'required':"年齡不能爲空",}, } #widgets用法,好比把輸入用戶名的input框給爲Textarea
        #首先得導入模塊
        from django.forms import widgets as wid #由於重名，因此起個別名
        widgets = { "name":wid.Textarea(attrs={"class":"c1"}) #還能夠自定義屬性
 } #labels，自定義在前端顯示的名字
        labels= { "name":"用戶名" }

而後在url對應的視圖函數中實例化這個類，把這個對象傳給前端

def student(request): if request.method == 'GET': student_list = StudentList() return render(request,'student.html',{'student_list':student_list}) 

　　而後前端只須要 {{ student_list.as_p }} 一下，全部的字段就都出來了，能夠用as_p顯示所有，也能夠經過for循環這student_list，拿到的是一個個input框，如今咱們就不用as_p，手動把這些input框搞出來，as_p拿到的頁面太醜。

　　首先 for循環這個student_list，拿到student對象，直接在前端打印這個student，是個input框student.label ，拿到數據庫中每一個字段的verbose_name ,若是沒有設置這個屬性，拿到的默認就是字段名，還能夠經過student.errors.0 拿到錯誤信息有了這些，咱們就能夠經過bootstrap，本身拼出來想要的樣式了，好比：

<body>
<div class="container">
    <h1>student</h1>
    <form method="POST" novalidate> {% csrf_token %}
 {# {{ student_list.as_p }}#} 
 {% for student in student_list %} <div class="form-group col-md-6"> {# 拿到數據字段的verbose_name,沒有就默認顯示字段名 #} <label class="col-md-3 control-label">{{ student.label }}</label>
                <div class="col-md-9" style="position: relative;">{{ student }}</div>
            </div> {% endfor %} <div class="col-md-2 col-md-offset-10">
            <input type="submit" value="提交" class="btn-primary">
        </div>
    </form>
</div>
</body>

如今還缺一個input框的form-contral樣式，能夠考慮在後臺的widget裏面添加，好比這樣：

from django.forms import widgets as wid #由於重名，因此起個別名
widgets = { "name":wid.TextInput(attrs={'class':'form-control'}), "age":wid.NumberInput(attrs={'class':'form-control'}), "email":wid.EmailInput(attrs={'class':'form-control'}) }

固然也能夠在js中，找到全部的input框，加上這個樣式，也行。

 

二、添加紀錄

保存數據的時候，不用挨個取數據了，只須要save一下

def student(request): if request.method == 'GET': student_list = StudentList() return render(request,'student.html',{'student_list':student_list}) else: student_list = StudentList(request.POST) if student_list.is_valid(): student_list.save() return redirect(request,'student_list.html',{'student_list':student_list})

 

三、編輯數據

　　若是不用ModelForm，編輯的時候得顯示以前的數據吧，還得挨個取一遍值，若是ModelForm，只須要加一個instance=obj（obj是要修改的數據庫的一條數據的對象）就能夠獲得一樣的效果
保存的時候要注意，必定要注意有這個對象（instance=obj），不然不知道更新哪個數據
代碼示例：

from django.shortcuts import render,HttpResponse,redirect from django.forms import ModelForm # Create your views here.
from app01 import models def test(request): # model_form = models.Student
    model_form = models.Student.objects.all() return render(request,'test.html',{'model_form':model_form}) class StudentList(ModelForm): class Meta: model = models.Student #對應的Model中的類
        fields = "__all__" #字段，若是是__all__,就是表示列出全部的字段
        exclude = None #排除的字段
        labels = None #提示信息
        help_texts = None #幫助提示信息
        widgets = None #自定義插件
        error_messages = None #自定義錯誤信息
        #error_messages用法：
        error_messages = { 'name':{'required':"用戶名不能爲空",}, 'age':{'required':"年齡不能爲空",}, } #widgets用法,好比把輸入用戶名的input框給爲Textarea
        #首先得導入模塊
        from django.forms import widgets as wid #由於重名，因此起個別名
        widgets = { "name":wid.Textarea } #labels，自定義在前端顯示的名字
        labels= { "name":"用戶名" } def student(request): if request.method == 'GET': student_list = StudentList() return render(request,'student.html',{'student_list':student_list}) else: student_list = StudentList(request.POST) if student_list.is_valid(): student_list.save() return render(request,'student.html',{'student_list':student_list}) def student_edit(request,pk): obj = models.Student.objects.filter(pk=pk).first() if not obj: return redirect('test') if request.method == "GET": student_list = StudentList(instance=obj) return render(request,'student_edit.html',{'student_list':student_list}) else: student_list = StudentList(request.POST,instance=obj) if student_list.is_valid(): student_list.save() return render(request,'student_edit.html',{'student_list':student_list})

　　總結： 從上邊能夠看到ModelForm用起來是很是方便的，好比增長修改之類的操做。可是也帶來額外很差的地方，model和form之間耦合了。若是不耦合的話，mf.save()方法也沒法直接提交保存。 可是耦合的話使用場景一般侷限用於小程序，寫大程序就最好不用了。

相關文章
相關標籤/搜索
每日一句
    每一个你不满意的现在，都有一个你没有努力的曾经。
本站公眾號
   歡迎關注本站公眾號,獲取更多信息
聯繫我們 最近搜索 最新文章 沪ICP备13005482号-10 MyBatis教程 SQL 教程 MySQL教程 Java 教程 Thymeleaf 教程 Hibernate教程 Spring教程 Redis教程