Form组件

Form组件初步使用

<form action="/add_name/" method="post">
    <label for="your_name">Your name: </label>
    <input id="your_name" type="text" name="your_name" value="{{ current_name }}">
    <input type="submit" value="OK">
</form>

from django import forms

class NameForm(forms.Form):
    your_name = forms.CharField(label='Your name', max_length=100)

def get_name(request):
    if request.method == 'POST':
        form = NameForm(request.POST)
        if form.is_valid():
            return HttpResponse('thanks')

    else:
        form = NameForm()
    return render(request, 'index.html', {'form': form})

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

<label for="id_your_name">Your name:</label>
<input type="text" name="your_name" maxlength="100" required="" id="id_your_name">

Form组件的组成内容

class LoginForm(forms.Form):
    ...
    pwd = forms.CharField(
        min_length=6,
        label="密码",
        widget=forms.widgets.PasswordInput(attrs={'class': 'c1'}, render_value=True)
    )

Fields

Fields arguments

Widgets 插件

FORM 后端 API

在模板内使用Form对象

• {{ form.as_table }}
• {{ form.as_p }}
• {{ form.as_ul }}

validators参数和自定义验证器

# 自定义一个函数,参数是传入的值,然后验证之后返回一个ValidationError.
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('手机号码格式错误')

phone = fields.CharField(validators=[mobile_validate, ],
                            error_messages={'required': '手机不能为空'},
                            widget=widgets.TextInput(attrs={'class': "form-control",
                                                          'placeholder': u'手机号码'}))

# 用内置的验证器生成新的实例对象,然后传给validators参数.
from django.core.validators import RegexValidator
class MyForm(Form):
    user = fields.CharField(
        validators=[RegexValidator(r'^[0-9]+$', '请输入数字'), RegexValidator(r'^159[0-9]+$', '数字必须以159开头')],
    )

RegexValidator(regex=None, message=None, code=None, inverse_match=None, flags=0)

正则验证器,一般使用前两个参数,传入正则表达式和错误信息,如果验证器未验证通过,就返回错误信息

• regex 是正则表达式
• message 是错误信息
• code是供 ValidationError 使用的错误代码,默认是invalid,一般无需改动
• 匹配模式,默认是False
• 用于regex是一个编译过的正则表达式,一般不用

EmailValidator(message=None, code=None, whitelist=None)

邮件验证器,EmailField默认使用该验证器

• message是错误信息
• code是错误代码
• whitelist是白名单,即只有在whitelist参数里的邮件地址才能通过验证

URLValidator(schemes=None, regex=None, message=None, code=None)

URL验证器,URL相关field默认使用该验证器

• schemes指URL方案,如果不指定,默认是['http', 'https', 'ftp', 'ftps']也就是只能通过HTTP和FTP协议的URL
• regex是正则表达式
• message是错误信息
• code是错误代码

validate_email

一个 EmailValidator 的不带任何参数的实例

validate_slug

一个正则表达式验证器的实例,仅能验证字母,数字,减号和下划线的组合

validate_unicode_slug

一个正则表达式验证器的实例,仅能验证UNICODE的字母,数字,减号和下划线的组合

validate_ipv4_address

一个正则表达式验证器的实例,验证合法的ipv4地址

validate_ipv6_address

这是一个用了django.utils.ipv6 模块的ipv6地址的验证器

validate_ipv46_address

实际上是同时使用了前边两个验证器的实例

validate_comma_separated_integer_list

一个正则表达式验证器的实例,验证逗号分割的数字

int_list_validator(sep=', ', message=None, code='invalid', allow_negative=False)

正则表达式验证器实例,用于检测字符串是否由一串整数被sep参数的分隔符分割后组成

• sep表示分隔符
• message为错误信息
• allow_negative表示是否允许负整数

MaxValueValidator(max_value, message=None)

最大值验证器,max_value参数默认使用该验证器

MinValueValidator(min_value, message=None)

最小值验证器

MaxLengthValidator(max_length, message=None)

最大长度验证器,

MinLengthValidator(min_length, message=None

最小长度验证器

DecimalValidator(max_digits, decimal_places)

Decimal类型验证器

• max_digits 是总的最长位数
• decimal_places 是小数的位数

还有两个文件验证器可以看这里