django Form控件

時間  2019-12-14
標籤 django form 控件 欄目 Python 简体版
原文   原文鏈接

Django的Form主要具備一下兩大功能：html

  -生成HTML的input標籤git

　　-編寫From類正則表達式

    　  - 本身編寫一個Form子類，抽象的歸納了想要的表單　　　數據庫

from django.forms import Form
from django.forms import widgets
from django.forms import fields

class MyForm(Form):
    user = fields.CharField() 
    gender = fields.ChoiceField（）
    city = fields.CharField()
    pwd = fields.CharField()

　　  - Form組件不生成一個form控件，只能定製其中的input標籤django

　　　　-包括input標籤的type，格式限定，label文本ide

　　　-type函數

插入field.Form 的widget屬性
如：
 user = fields.CharField(
     initial=2,
     widget=widgets.RadioSelect(choices=((1,'上海'),(2,'北京'),))
 )

TextInput(Input)
NumberInput(TextInput)
EmailInput(TextInput)
URLInput(TextInput)
PasswordInput(TextInput)
HiddenInput(TextInput)
Textarea(Widget)
DateInput(DateTimeBaseInput)
DateTimeInput(DateTimeBaseInput)
TimeInput(DateTimeBaseInput)
CheckboxInput
Select
NullBooleanSelect
SelectMultiple
RadioSelect
CheckboxSelectMultiple
FileInput
ClearableFileInput
MultipleHiddenInput
SplitDateTimeWidget
SplitHiddenDateTimeWidget
SelectDateWidget

　　　-格式限定，先引入from django import formsui

　　　　而後，book=forms.ModelChoiceField()this

Field
    required=True,               是否必須填寫,
    widget=TextInput,                 HTML插件
    hidden_widget = HiddenInput  
    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=Select,             插件，默認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類型
    ...

　　  -labelspa

在對應限定類型中的label參數中輸入

　　  -提示錯誤信息，

Form的error_messages中指定
error_messages={'required': '標題不能爲空',
                'min_length': '標題最少爲5個字符',
                'max_length': '標題最多爲20個字符'}

　　  -標籤的class，

在widget的attr參數中寫定
如：
widget=widgets.TextInput(attrs={'class': "form-control",
                                'placeholder': u'手機號碼'}))　　　　

　　- 生成實例
　　  -form_obj=Myform({}),輸入一個字典類型，鍵值對的鍵會對應上input標籤的name，值會傳入其中

class BaseForm(object):
    # This is the main implementation of all the Form logic. Note that this
    # class is different than Form. See the comments by the Form class for more
    # information. Any improvements to the form API should be made to *this*
    # class, not to the Form class.
    default_renderer = None
    field_order = None
    prefix = None
    use_required_attribute = True

    def __init__(self, data=None, files=None, auto_id='id_%s', prefix=None,
                 initial=None, error_class=ErrorList, label_suffix=None,
                 empty_permitted=False, field_order=None, use_required_attribute=None, renderer=None):
        self.is_bound = data is not None or files is not None
        self.data = data or {}
        self.files = files or {}
        self.auto_id = auto_id
        if prefix is not None:
            self.prefix = prefix
        self.initial = initial or {}
        self.error_class = error_class
        # Translators: This is the default suffix added to form field labels
        self.label_suffix = label_suffix if label_suffix is not None else _(':')
        self.empty_permitted = empty_permitted
        self._errors = None  # Stores the errors after clean() has been called.

        # The base_fields class attribute is the *class-wide* definition of
        # fields. Because a particular *instance* of the class might want to
        # alter self.fields, we create self.fields here by copying base_fields.
        # Instances should always modify self.fields; they should not modify
        # self.base_fields.
        self.fields = copy.deepcopy(self.base_fields)
        self._bound_fields_cache = {}
        self.order_fields(self.field_order if field_order is None else field_order)

        if use_required_attribute is not None:
            self.use_required_attribute = use_required_attribute

        # Initialize form renderer. Use a global default if not specified
        # either as an argument or as self.default_renderer.
        if renderer is None:
            if self.default_renderer is None:
                renderer = get_default_renderer()
            else:
                renderer = self.default_renderer
                if isinstance(self.default_renderer, type):
                    renderer = renderer()
        self.renderer = renderer
Form（ BaseForm）

　　-加入response

　　　　  - render（request，'',{'form':form_obj}），

  -驗證用戶數據

　　-接收request數據。

　　　　-生成一個自定製的from類　　　　

　　-驗證數據，得出一個結果，

　　　　- 編寫驗證規則

　　　　   - django自帶的規則

　　　　   -  自定義規則　　　　　

from django.forms import Form
from django.forms import widgets
from django.forms import fields
from django.core.validators import RegexValidator
 
class MyForm(Form):
    phone = fields.CharField(min_length=11,max_length=11,
        validators=[RegexValidator(r'^[0-9]+$', '請輸入數字'), RegexValidator(r'^159[0-9]+$', '數字必須以159開頭')],
    )
validators做用是附加驗證
validators數據類型爲列表，每一個元素是RegexValidator的實例，第一個參數是正則表達式，第二個參數是拋出的錯誤信息。　　

　　　　   - 自定義邏輯規則：

if data['againpwd'] and data['againpwd'] != data['password']:
     reg_obj.add_error('againpwd', '兩次密碼不一致')     #實時的加入對應錯誤信息
     errors_dict = {'errors': list(reg_obj.errors)}
     return render(request, 'register.html', {'regform': reg_obj, 'errors_list': errors_dict})

 　　　　   -局部自定義鉤子函數

def clean_username(self): # 函數名和和input框名字同樣，只做用於相應字段
    print('woshi clean_username')
def clean_password(self):
    print('woshi clean_password')

def clean_passworddfsdfs(self):
    print('woshi clean_passworddfsdfs')

　　　　- 驗證，得出判斷結果

　　　　　- form_obj.is_vaild()會獲得一個布爾型的返回值

　　　　   - 上一步以前，cleaned_data是沒有值的

　　　　- 以form形式提交收到錯誤，而後標紅對應input框

　　　　　- input標籤下面errors屬性（列表類型）　

　　　　   - 在Html中用模板語言取到錯誤信息，包括錯誤input框name和其錯誤信息

　　　　   　　- 使用js取 ,把name作成一個列表，而後用字典的方式送到網頁，用js取出，{{errorlist| safe}} js要用safa關鍵字

　　　　　　   - form_obj

　　-若是結果不對，自動修改input標籤樣式

　　　　-   取到錯誤信息的name，用js修改　

form控件接受數據，提交數據庫：一對一提交，以及一對多提交　：

　　- clean_data  中 一對一關係，ModelChoiceField字段，收到的是一個對應的表的實例

　　　　一對多關係，ModelMultipleChoiceField ,收到的是一個Queryset 實例。

　　　　

　　- 實際上數據中，多對多關係，會新建一張表，這張表的內容依賴其餘兩張創建關係的表而存在

　　- 多對多關係表插入數據必需要在主表插入相應數據以後

　　- 具體插入使用 主表相應實例對象的多對多字段的add方法

　　　　- add方法能夠插入對應副表的pk值，pk值列表，副表對象，Queryset對象，Queryset的數據類型是列表，要註明（加*）

參考

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