django表單的Widgets使用詳解

更新時(shí)間：2019年07月22日 14:13:41 作者：NAVYSUMMER

這篇文章主要介紹了django表單的Widgets,文中通過示例代碼介紹的非常詳細(xì)，對(duì)大家的學(xué)習(xí)或者工作具有一定的參考學(xué)習(xí)價(jià)值,需要的朋友可以參考下

前言

不要將Widget與表單的fields字段混淆。表單字段負(fù)責(zé)驗(yàn)證輸入并直接在模板中使用。而Widget負(fù)責(zé)渲染網(wǎng)頁(yè)上HTML表單的輸入元素和提取提交的原始數(shù)據(jù)。widget是字段的一個(gè)內(nèi)在屬性，用于定義字段在瀏覽器的頁(yè)面里以何種HTML元素展現(xiàn)。

一、指定使用的widget

每個(gè)字段都有一個(gè)默認(rèn)的widget類型。如果你想要使用一個(gè)不同的Widget，可以在定義字段時(shí)使用widget參數(shù)。像這樣：

from django import forms

class CommentForm(forms.Form):
  name = forms.CharField()
  url = forms.URLField()
  comment = forms.CharField(widget=forms.Textarea)

這將使用一個(gè)Textarea Widget來展現(xiàn)表單的評(píng)論字段，而不是默認(rèn)的TextInput Widget。

二、設(shè)置widget的參數(shù)

許多widget具有可選的額外參數(shù)，下面的示例中，設(shè)置了SelectDateWidget的years 屬性，注意參數(shù)的傳遞方法：

from django import forms

BIRTH_YEAR_CHOICES = ('1980', '1981', '1982')
FAVORITE_COLORS_CHOICES = (
  ('blue', 'Blue'),
  ('green', 'Green'),
  ('black', 'Black'),
)

class SimpleForm(forms.Form):
  birth_year = forms.DateField(widget=forms.SelectDateWidget(years=BIRTH_YEAR_CHOICES))
  favorite_colors = forms.MultipleChoiceField(
    required=False,
    widget=forms.CheckboxSelectMultiple,
    choices=FAVORITE_COLORS_CHOICES,
  )

三、為widget添加CSS樣式

默認(rèn)情況下，當(dāng)Django渲染W(wǎng)idget為實(shí)際的HTML代碼時(shí)，不會(huì)幫你添加任何的CSS樣式，也就是說網(wǎng)頁(yè)上所有的TextInput元素的外觀是一樣的。

看下面的表單：

from django import forms

class CommentForm(forms.Form):
  name = forms.CharField()
  url = forms.URLField()
  comment = forms.CharField()

這個(gè)表單包含三個(gè)默認(rèn)的TextInput Widget，以默認(rèn)的方式渲染，沒有CSS類、沒有額外的屬性。每個(gè)Widget的輸入框?qū)秩镜靡荒Ｒ粯?，丑陋又單調(diào)：

>>> f = CommentForm(auto_id=False)
>>> f.as_table()
<tr><th>Name:</th><td><input type="text" name="name" required /></td></tr>
<tr><th>Url:</th><td><input type="url" name="url" required /></td></tr>
<tr><th>Comment:</th><td><input type="text" name="comment" required /></td></tr>

在真正的網(wǎng)頁(yè)中，你可ending不想讓每個(gè)Widget看上去都一樣?？赡芟胍ocomment一個(gè)更大的輸入框，可能想讓‘name' Widget具有一些特殊的CSS類。

可以在創(chuàng)建Widget時(shí)使用Widget.attrs參數(shù)來實(shí)現(xiàn)這一目的：

class CommentForm(forms.Form):
  name = forms.CharField(widget=forms.TextInput(attrs={'class': 'special'}))
  url = forms.URLField()
  comment = forms.CharField(widget=forms.TextInput(attrs={'size': '40'}))

注意參數(shù)的傳遞方式！

這次渲染后的結(jié)果就不一樣了：

>>> f = CommentForm(auto_id=False)
>>> f.as_table()
<tr><th>Name:</th><td><input type="text" name="name" class="special" required /></td></tr>
<tr><th>Url:</th><td><input type="url" name="url" required /></td></tr>
<tr><th>Comment:</th><td><input type="text" name="comment" size="40" required /></td></tr>

以上就是本文的全部?jī)?nèi)容，希望對(duì)大家的學(xué)習(xí)有所幫助，也希望大家多多支持腳本之家。

您可能感興趣的文章: