Django組件-Forms組件

時間 2019-12-01

標籤 django 組件 forms 欄目 Python 简体版

原文原文鏈接

Django的Forms組件主要有如下幾大功能：html

頁面初始化，生成HTML標籤
校驗用戶數據（顯示錯誤信息）
HTML Form提交保留上次提交數據

1、小試牛刀

　　一、定義Form類python

from django import forms


class EmpForm(forms.Form):
    name = forms.CharField(min_length=5, label="姓名", error_messages={"required": "該字段不能爲空!",
                                                                     "min_length": "用戶名過短。"})
    age = forms.IntegerField(label="年齡")
    salary = forms.DecimalField(max_digits=5, decimal_places=2, label="工資")

　　二、設計url與視圖對應關係git

from django.urls import path
from app01 import views

urlpatterns = [
    path('add_emp/', views.add_emp),
]

　　三、視圖函數正則表達式

from app01.MyForms import EmpForm

def add_emp(request):
    if request.method == "GET":
        form = EmpForm()  # 初始化form對象
        return render(request, "add_emp.html", {"form":form})
    else:
        form = EmpForm(request.POST)  # 將數據傳給form對象
        if form.is_valid():  # 進行校驗
            data = form.cleaned_data  # 校驗經過的數據，字典
            print(data)
            models.Emp.objects.create(**data)
            return redirect("/index/")
        else:  # 校驗失敗
            print(form.errors)
            return render(request, "add_emp.html", {"form": form})

　　四、模板文件數據庫

<!DOCTYPE html>
<html lang="en">
<head>
    <meta charset="UTF-8">
    <title></title>
</head>
<body>

<h3>添加員工</h3>

{#一、本身手動寫HTML頁面#}
{#<form action="" method="post">#}
{#    <p>姓名：<input type="text" name="name"></p>#}
{#    <p>年齡：<input type="text" name="age"></p>#}
{#    <p>工資：<input type="text" name="salary"></p>#}
{#    <input type="submit">#}
{#</form>#}

{#二、經過form對象的as_p方法實現#}
{#<form action="" method="post" novalidate>#}
{#    {% csrf_token %}#}
{#    {{ form.as_p }}#}
{#    <input type="submit">#}
{#</form>#}

{#三、手動獲取form對象的字段#}
{#<form action="" method="post" novalidate>#}
{#    {% csrf_token %}#}
{#    <div>#}
{#        <label for="id_{{ form.name.name }}">姓名</label>#}
{#        {{ form.name }} <span>{{ form.name.errors.0 }}</span>#}
{#    </div>#}
{#    <div>#}
{#        <label for="id_{{ form.age.name }}">年齡</label>#}
{#        {{ form.age }} <span>{{ form.age.errors.0 }}</span>#}
{#    </div>#}
{#    <div>#}
{#        <label for="id_salary">工資</label>#}
{#        {{ form.salary }} <span>{{ form.salary.errors.0 }}</span>#}
{#    </div>#}
{#    <input type="submit">#}
{#</form>#}


{#四、用for循環展現全部字段#}
<form action="" method="post" novalidate>
    {% csrf_token %}
    {% for field in form %}
        <div>
            <label for="id_{{ field.name }}">{{ field.label }}</label>
            {{ field }} <span>{{ field.errors.0 }}</span>
        </div>
    {% endfor %}
    <input type="submit">
</form>

</body>
</html>

　　附：Django內置的字段及屬性django

Field
    required=True,               是否容許爲空
    widget=None,                 HTML插件
    label=None,                  用於生成Label標籤或顯示內容
    initial=None,                初始值
    help_text='',                幫助信息(在標籤旁邊顯示)
    error_messages=None,         錯誤信息 {'required': '不能爲空', 'invalid': '格式錯誤'}
    show_hidden_initial=False,   是否在當前插件後面再加一個隱藏的且具備默認值的插件（可用於檢驗兩次輸入是否一直）
    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內置字段

2、局部鉤子和全局鉤子

　　一、定義Form類app

from django import forms
from django.core.exceptions import ValidationError
from app01 import models


class EmpForm(forms.Form):
    name = forms.CharField(min_length=5, label="姓名", error_messages={"required": "該字段不能爲空!",
                                                                     "min_length": "用戶名過短。"})
    age = forms.IntegerField(label="年齡")
    salary = forms.DecimalField(max_digits=5, decimal_places=2, label="工資")
    r_salary = forms.DecimalField(max_digits=5, decimal_places=2, label="請再輸入工資")

    def clean_name(self):  # 局部鉤子
        val = self.cleaned_data.get("name")

        if val.isdigit():
            raise ValidationError("用戶名不能是純數字")
        elif models.Emp.objects.filter(name=val):
            raise ValidationError("用戶名已存在！")
        else:
            return val

    def clean(self):  # 全局鉤子 確認兩次輸入的工資是否一致。
        val = self.cleaned_data.get("salary")
        r_val = self.cleaned_data.get("r_salary")

        if val == r_val:
            return self.cleaned_data
        else:
            raise ValidationError("請確認工資是否一致。")

　　二、視圖函數ide

def add_emp(request):
    if request.method == "GET":
        form = EmpForm()  # 初始化form對象
        return render(request, "add_emp.html", {"form":form})
    else:
        form = EmpForm(request.POST)  # 將數據傳給form對象
        if form.is_valid():  # 進行校驗
            data = form.cleaned_data
            data.pop("r_salary")
            models.Emp.objects.create(**data)
            return redirect("/index/")
        else:  # 校驗失敗
            clear_errors = form.errors.get("__all__")  # 獲取全局鉤子錯誤信息
            return render(request, "add_emp.html", {"form": form, "clear_errors": clear_errors})

　　三、模板文件函數

<form action="" method="post" novalidate>
    {% csrf_token %}
    <div>
        <label for="id_{{ form.name.name }}">姓名</label>
        {{ form.name }} <span>{{ form.name.errors.0 }}</span>
    </div>
    <div>
        <label for="id_{{ form.age.name }}">年齡</label>
        {{ form.age }} <span>{{ form.age.errors.0 }}</span>
    </div>
    <div>
        <label for="id_salary">工資</label>
        {{ form.salary }} <span>{{ form.salary.errors.0 }}{{ clear_errors.0 }}</span>
    </div>
    <div>
        <label for="id_r_salary">請再輸入工資</label>
        {{ form.r_salary }} <span>{{ form.r_salary.errors.0 }}{{ clear_errors.0 }}</span>
    </div>
    <input type="submit">
</form>

相關標籤/搜索

每日一句

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