Поля формы¶

class Field(**kwargs)¶

При создании класса Form наиболее важной деталью является определение полей формы. Каждое поле обладает собственной логикой проверки вводимых данных наряду с дополнительными возможностями.

Field.clean(value)¶

Несмотря на то, что обычно классы Field используются внутри классов Form, вы можете создавать их объекты самостоятельно, чтобы понять как они работают. Каждый экземпляр класса Field имеет метод clean(), который принимает единственный аргумент и который вызывает исключение django.forms.ValidationError в случае ошибки или возвращает чистое значение:

>>> from django import forms
>>> f = forms.EmailField()
>>> f.clean('foo@example.com')
u'foo@example.com'
>>> f.clean(u'foo@example.com')
u'foo@example.com'
>>> f.clean('invalid email address')
Traceback (most recent call last):
...
ValidationError: [u'Enter a valid e-mail address.']

Базовые аргументы поля¶

Каждый конструктор класса Field принимает эти аргументы. Некоторые классы Field принимают дополнительные аргументы. Перечисленные ниже аргументы принимаются всеми полями:

`required`¶

Field.required¶

По умолчанию каждый класс FieldB предполагает значение обязательным. Таким образом, если вы передадите ему пустое значение, т.е. None или пустую строку (""), то метод clean() вызовет исключение ValidationError:

>>> f = forms.CharField()
>>> f.clean('foo')
u'foo'
>>> f.clean('')
Traceback (most recent call last):
...
ValidationError: [u'This field is required.']
>>> f.clean(None)
Traceback (most recent call last):
...
ValidationError: [u'This field is required.']
>>> f.clean(' ')
u' '
>>> f.clean(0)
u'0'
>>> f.clean(True)
u'True'
>>> f.clean(False)
u'False'

Для того, чтобы сделать поле “необязательным” передайте required=False в конструктор Field:

>>> f = forms.CharField(required=False)
>>> f.clean('foo')
u'foo'
>>> f.clean('')
u''
>>> f.clean(None)
u''
>>> f.clean(0)
u'0'
>>> f.clean(True)
u'True'
>>> f.clean(False)
u'False'

Если Field получило required=False и вы передали в метод clean() пустое значение, то метод вернёт номализованное пустое значение, а не вызовет исключение ValidationError. Для CharField таким значением будет юникодная пустая строка. Для других классов Field этим значением может быть None. (Это поведение меняется от поля к полю.)

`label`¶

Field.label¶

Аргумент label позволяет вам определить “видимую людьми” метку для этого поля. Оно используется когда Field отображается на форме.

Как показано ранее в Выдаче формы в виде HTML, стандартная метка для Field создаётся из имени поля, с преобразованием всех символов подчёркивания в пробелы и переводом первой буквы в верхний регистр. Укажите label, если это стандартная метка не подходит для вашей задачи.

Ниже приведён пример формы, которая определяет метки для двух своих полей. Мы используем auto_id=False для упрощения вывода:

>>> class CommentForm(forms.Form):
...     name = forms.CharField(label='Your name')
...     url = forms.URLField(label='Your Web site', required=False)
...     comment = forms.CharField()
>>> f = CommentForm(auto_id=False)
>>> print f
<tr><th>Your name:</th><td><input type="text" name="name" /></td></tr>
<tr><th>Your Web site:</th><td><input type="text" name="url" /></td></tr>
<tr><th>Comment:</th><td><input type="text" name="comment" /></td></tr>

`initial`¶

Field.initial¶

Аргумент initial позволяет определять начальное значение для поля, при его отображении на незаполненной форме.

Для определения динамических начальных данных, используйте параметр Form.initial.

Использование этого аргумента подходит для отображения пустой формы, в которой поля будут иметь указанные значения. Например:

>>> class CommentForm(forms.Form):
...     name = forms.CharField(initial='Your name')
...     url = forms.URLField(initial='http://')
...     comment = forms.CharField()
>>> f = CommentForm(auto_id=False)
>>> print f
<tr><th>Name:</th><td><input type="text" name="name" value="Your name" /></td></tr>
<tr><th>Url:</th><td><input type="text" name="url" value="http://" /></td></tr>
<tr><th>Comment:</th><td><input type="text" name="comment" /></td></tr>

Вам могло придти в голову просто передать словарь с начальными значениями при отображении формы. Но если так сделать, то вы запустите механизм проверки данных и HTML код формы будет содержать в себе результаты этой проверки:

>>> class CommentForm(forms.Form):
...     name = forms.CharField()
...     url = forms.URLField()
...     comment = forms.CharField()
>>> default_data = {'name': 'Your name', 'url': 'http://'}
>>> f = CommentForm(default_data, auto_id=False)
>>> print f
<tr><th>Name:</th><td><input type="text" name="name" value="Your name" /></td></tr>
<tr><th>Url:</th><td><ul class="errorlist"><li>Enter a valid URL.</li></ul><input type="text" name="url" value="http://" /></td></tr>
<tr><th>Comment:</th><td><ul class="errorlist"><li>This field is required.</li></ul><input type="text" name="comment" /></td></tr>

Это главная причина, по которой начальные значения отображаются только на незаполненных формах. Для заполненных форм, HTML код всегда будет содержать введённые в форму данные.

Также следует отметить, что начальные значения не используются в качестве значений по умолчанию во время проведения проверки данных в полях формы. Начальные значения, определённые в initial предназначены лишь для первого отображения формы:

>>> class CommentForm(forms.Form):
...     name = forms.CharField(initial='Your name')
...     url = forms.URLField(initial='http://')
...     comment = forms.CharField()
>>> data = {'name': '', 'url': '', 'comment': 'Foo'}
>>> f = CommentForm(data)
>>> f.is_valid()
False
# The form does *not* fall back to using the initial values.
>>> f.errors
{'url': [u'This field is required.'], 'name': [u'This field is required.']}

Вместо констант вы также можете передавать любой исполняемый объект (callable):

>>> import datetime
>>> class DateForm(forms.Form):
...     day = forms.DateField(initial=datetime.date.today)
>>> print DateForm()
<tr><th>Day:</th><td><input type="text" name="day" value="12/23/2008" /><td></tr>

Исполняемый объект будет вычислен только в момент отображения незаполненной формы.

`help_text`¶

Field.help_text¶

Аргумент help_text позволяет указать описание для поля. Если вы укажете help_text, он будет показан около поля при отображении формы с помощью вспомогательных методов Form (например, через as_ul()).

Ниже представлен пример формы, в которой help_text определён у двух полей. Мы используем auto_id=False для упрощения вывода:

>>> class HelpTextContactForm(forms.Form):
...     subject = forms.CharField(max_length=100, help_text='100 characters max.')
...     message = forms.CharField()
...     sender = forms.EmailField(help_text='A valid email address, please.')
...     cc_myself = forms.BooleanField(required=False)
>>> f = HelpTextContactForm(auto_id=False)
>>> print f.as_table()
<tr><th>Subject:</th><td><input type="text" name="subject" maxlength="100" /><br /><span class="helptext">100 characters max.</span></td></tr>
<tr><th>Message:</th><td><input type="text" name="message" /></td></tr>
<tr><th>Sender:</th><td><input type="text" name="sender" /><br />A valid email address, please.</td></tr>
<tr><th>Cc myself:</th><td><input type="checkbox" name="cc_myself" /></td></tr>
>>> print f.as_ul()
<li>Subject: <input type="text" name="subject" maxlength="100" /> <span class="helptext">100 characters max.</span></li>
<li>Message: <input type="text" name="message" /></li>
<li>Sender: <input type="text" name="sender" /> A valid email address, please.</li>
<li>Cc myself: <input type="checkbox" name="cc_myself" /></li>
>>> print f.as_p()
<p>Subject: <input type="text" name="subject" maxlength="100" /> <span class="helptext">100 characters max.</span></p>
<p>Message: <input type="text" name="message" /></p>
<p>Sender: <input type="text" name="sender" /> A valid email address, please.</p>
<p>Cc myself: <input type="checkbox" name="cc_myself" /></p>

`error_messages`¶

Field.error_messages¶

Аргумент error_messages позволяет изменить стандартные сообщения об ошибках, которые выдаёт поле. Создайте словарь с ключами тех сообщений, которые вы желаете изменить. Например, стандартное сообщение об ошибке:

>>> generic = forms.CharField()
>>> generic.clean('')
Traceback (most recent call last):
  ...
ValidationError: [u'This field is required.']

А вот собственное сообщение об ошибке:

>>> name = forms.CharField(error_messages={'required': 'Please enter your name'})
>>> name.clean('')
Traceback (most recent call last):
  ...
ValidationError: [u'Please enter your name']

В разделе классы встроенных полей показано, что каждое поле определяет ключи сообщений об ошибках, которые оно использует.

`validators`¶

Добавлено в Django 1.2: Пожалуйста, обратитесь к описанию релиза

Field.validators¶

Аргумент validators позволяет указать список функций, осуществляющих проверку поля.

Обратитесь к документации на валидаторы для подробной информации.

`localize`¶

Добавлено в Django 1.2: Пожалуйста, обратитесь к описанию релиза

Field.localize¶

Аргумент localize включает локализацию для данных формы, как на входе, так и на выходе.

Обратитесь к документации на формат локализации для подробной информации.

Классы встроенных полей¶

Библиотека форм поставляется с набором классов Field, которые предоставляют решение общих задач проверки данных. Этот раздел описывает каждое встроенное поле.

Для каждого поля мы указываем виджет, который используется в случае, если вы явно не определили нужный вам виджет. Мы также указываем значение, которое будет возвращено, если вы предоставили пустое значение (см. required).

`BooleanField`¶

class BooleanField(**kwargs)¶

Стандартный виджет: CheckboxInput.
Пустое значение: False.
Возвращает: True или False языка Python.
Гарантирует, что значение равно True (т.е. чекбокс отмечен), если поле имеет атрибут required=True.
Ключи сообщений об ошибках: required.

Примечание

Так как все потомки Field по умолчанию имеют required=True, это условие проверки имеет большое значение. Если вам требуется включить в свою форму булево значение, которое может принимать значения True или False (т.е. отмеченный или неотмеченный чекбокс), то вы должны передать required=False в создаваемое поле BooleanField.

`CharField`¶

class CharField(**kwargs)¶

Стандартный виджет: TextInput.
Пустое значение: '' (пустая строка).
Возвращает: Объект Unicode.
Проверяет max_length или min_length, если они указаны. В противном случае, любые значения будут правильными.
Ключи сообщений об ошибках: required, max_length, min_length.

Имеет два необязательных аргумента для проверки:

max_length¶

min_length¶

Если они указаны, то производится соответствующая проверка длины полученной строки.

`ChoiceField`¶

class ChoiceField(**kwargs)¶

Стандартный виджет: Select.
Пустое значение: '' (пустая строка).
Возвращает: Объект Unicode.
Проверяет, что введённое значение присутствует в списке вариантов.
Ключи сообщений об ошибках: required, invalid_choice.

Сообщение об ошибке invalid_choice может содержать %(value)s, которое будет замещено выбранным вариантом.

Принимает один дополнительный обязательный аргумент:

choices¶: Итерируемый объект (т.е. список или кортеж), содержащий ряд двухэлементных кортежей, для использования в качестве вариантов для данного поля. Этот аргумент принимает те же форматы, что и аргумент choices поля модели. Обратитесь к справочнику по полям модели для подробной информации.

`TypedChoiceField`¶

class TypedChoiceField(**kwargs)¶

Аналогично ChoiceField, но TypedChoiceField принимает два дополнительных аргумента, coerce и empty_value.

Стандартный виджет: Select.
Пустое значение: Всё, что вы назовёте empty_value.
Возвращает: Значение типа, указанного аргументом coerce.
Проверяет, что полученное значение присутствует в списке вариантов и может быть преобразовано в нужный тип.
Ключи сообщений об ошибках: required, invalid_choice.

Принимает дополнительные аргументы:

coerce¶: Функция, которая принимает один аргумент и возвращает преобразованное значение. Примеры включают встроенные int, float, bool и другие типы. Defaults to an identity function.

empty_value¶: Значение, используемое для представления “пустоты”. Обычно это пустая строка. None является ещё одним вариантом. Следует отметить, что это значение не будет преобразовываться функцией, определённой аргументом coerce, так что выбирайте значение соответственно.

`DateField`¶

class DateField(**kwargs)¶

Стандартный виджет: DateInput
Пустое значение: None.
Возвращает: Объект datetime.date языка Python.
Проверяет, что полученное значение является объектом datetime.date, datetime.datetime или строкой, отформатированной в нужном виде.
Ключи сообщений об ошибках: required, invalid.

Принимает один необязательный аргумент:

input_formats¶: Список форматов, используемых при попытках сконвертировать строку в объект datetime.date.

Если аргумент input_formats не предоставлен, то используются следующие форматы:

'%Y-%m-%d', '%m/%d/%Y', '%m/%d/%y', # '2006-10-25', '10/25/2006', '10/25/06'
'%b %d %Y', '%b %d, %Y',            # 'Oct 25 2006', 'Oct 25, 2006'
'%d %b %Y', '%d %b, %Y',            # '25 Oct 2006', '25 Oct, 2006'
'%B %d %Y', '%B %d, %Y',            # 'October 25 2006', 'October 25, 2006'
'%d %B %Y', '%d %B, %Y',            # '25 October 2006', '25 October, 2006'

`DateTimeField`¶

class DateTimeField(**kwargs)¶

Стандартный виджет: DateTimeInput.
Пустое значение: None.
Возвращает: Объект datetime.datetime языка Python.
Проверяет, что полученное значение является объектом datetime.datetime, datetime.date или строкой, отформатированной в нужном виде.
Ключи сообщений об ошибках: required, invalid.

Принимает один необязательный аргумент:

input_formats¶: Список форматов, используемых при попытках сконвертировать строку в объект datetime.datetime.

Если аргумент input_formats не предоставлен, то используются следующие форматы:

'%Y-%m-%d %H:%M:%S',     # '2006-10-25 14:30:59'
'%Y-%m-%d %H:%M',        # '2006-10-25 14:30'
'%Y-%m-%d',              # '2006-10-25'
'%m/%d/%Y %H:%M:%S',     # '10/25/2006 14:30:59'
'%m/%d/%Y %H:%M',        # '10/25/2006 14:30'
'%m/%d/%Y',              # '10/25/2006'
'%m/%d/%y %H:%M:%S',     # '10/25/06 14:30:59'
'%m/%d/%y %H:%M',        # '10/25/06 14:30'
'%m/%d/%y',              # '10/25/06'

`DecimalField`¶

class DecimalField(**kwargs)¶

Стандартный виджет: TextInput.
Пустое значение: None.
Возвращает: Тип decimal языка Python.
Проверяет, что полученное значение является десятичным. Пробелы до и после значения игнорируются.
Ключи сообщений об ошибках: required, invalid, max_value, min_value, max_digits, max_decimal_places, max_whole_digits.

Сообщения об ошибках max_value и min_value могут содержать шаблон``%(limit_value)s``, который будет заполнен соответствующим значением.

Принимает четыре необязательных аргумента:

max_value¶

min_value¶: Эти аргументы управляют диапазоном значений, разрешённых для ввода в поле, и должны быть заполнены значениями decimal.Decimal.

max_digits¶: Максимальное число разрядов (до и после десятичной точки, впередистоящие нули обрезаются) разрешённых в значении.

decimal_places¶: Максимальное число разрешённых десятичных разрядов.

`EmailField`¶

class EmailField(**kwargs)¶

Стандартный виджет: TextInput.
Пустое значение: '' (пустая строка).
Возвращает: Объект Unicode.
Проверяет, что полученное значение является правильным адресом электронной почты, используя досточно сложное регулярное выражение.
Ключи сообщений об ошибках: required, invalid.

Имеет два необязательных аргумента: max_length и min_length. Если аргументы указаны, то они контролируют диапазон принимаемого значения.

Изменено в Django 1.2: The EmailField previously did not recognize email addresses as valid that contained an IDN (Internationalized Domain Name; a domain containing unicode characters) domain part. This has now been corrected.

`FileField`¶

class FileField(**kwargs)¶

Стандартный виджет: ClearableFileInput.
Пустое значение: None.
Возвращает: Объект UploadedFile, который оборачивает содержимое файла и его имя в единый объект.
Может проверять, что данные непустого файла были связаны с формой.
Ключи сообщений об ошибках: required, invalid, missing, empty, max_length.

Имеет два необязательных аргумента: max_length и allow_empty_file. Если аргументы указаны, то первый ограничивает длину имени файла, а второй позволяет загружать даже пустые файлы.

Для получения подробностей об объекте ``UploadedFile`, см. документацию по загрузке файлов.

При использовании FileField на форме, вы должны не забыть связать данные файла с формой.

Ошибка max_length относится к длине имени файла. В сообщении об ошибке шаблон %(max)d будет заменён максимальной длиной имени файла, а %(length)d – длиной имени текущего файла.

`FilePathField`¶

class FilePathField(**kwargs)¶

Стандартный виджет: Select.
Пустое значение: None.
Возвращает: Объект Unicode.
Проверяет, что выбоанное значение присутствует в списке вариантов.
Ключи сообщений об ошибках: required, invalid_choice.

Поле позволяет выбирать файл из определённого каталога. Оно принимает три дополнительных аргумента, требуя обязательного наличия аргумента path:

path¶: Абсолютный путь до каталога, содержимое которого вы желаете отобразить. Этот каталог должен существовать.

recursive¶: Если False (по умолчанию), то будет показано только содержимое каталога, указанного в path. Если True, то будет показано также и содержимое всех вложенных каталогов.

match¶: Шаблон регулярного выражения. Отображаться будут только те файлы, которые подходят под указанное регулярное выражение.

`FloatField`¶

class FloatField(**kwargs)¶

Стандартный виджет: TextInput.
Пустое значение: None.
Возвращает: Тип float языка Python.
Проверяет, что полученное значение является числом с плавающей точкой. Пробелы до и после значения не влияют на преобразование значения, так как эта ситуация обрабатывается функцией float() языка Python.
Ключи сообщений об ошибках: required, invalid, max_value, min_value.

Принимает два необязательных аргумента для проверки: max_value и min_value. Они определяют диапазон значений, разрешённый для поля.

`ImageField`¶

class ImageField(**kwargs)¶

Стандартный виджет: ClearableFileInput.
Пустое значение: None.
Возвращает: Объект UploadedFile, который оборачивает содержимое файла и его имя в единый объект.
Проверяет, что данные файла были связаны с формой, а затем, что файл является изображением, формат которого поддерживается библиотекой PIL.
Ключи сообщений об ошибках: required, invalid, missing, empty, invalid_image.

Использование ImageField требует установки Python Imaging Library.

При использовании ImageField на форме, вы должны не забыть связать данные файла с формой.

`IntegerField`¶

class IntegerField(**kwargs)¶

Стандартный виджет: TextInput.
Пустое значение: None.
Возвращает: Тип integer или long языка Python.
Проверяет, что полученное значение является целым числом. Пробелы до и после значения не влияют на преобразование значения, так как эта ситуация обрабатывается функцией int() языка Python.
Ключи сообщений об ошибках: required, invalid, max_value, min_value.

Сообщения об ошибках max_value и min_value могут содержать шаблон``%(limit_value)s``, который будет заполнен соответствующим значением.

Принимает два необязательных аргумента для проверки:

max_value¶

min_value¶

Они определяют диапазон значений, разрешённый для поля.

`IPAddressField`¶

class IPAddressField(**kwargs)¶

Стандартный виджет: TextInput.
Пустое значение: '' (пустая строка).
Возвращает: Объект Unicode.
Проверяет с помощью регулярного выражения, что полученное значение является правильным IPv4 адресом.
Ключи сообщений об ошибках: required, invalid.

`GenericIPAddressField`¶

Добавлено в Django 1.4: Пожалуйста, обратитесь к описанию релиза

class GenericIPAddressField(**kwargs)¶

Поле для обработки адресов IPv4 или IPv6.

Стандартный виджет: TextInput.
Пустое значение: '' (пустая строка).
Возвращает: Объект Unicode. Преобразование IPv6 адресов описано далее.
Проверяет, что полученное значение является правильным IP адресом.
Ключи сообщений об ошибках: required, invalid.

IPv6 адрес преобразуется в соответствии с RFC 4291, секция 2.2, включая использование формата IPv4, предложенного в параграфе 3 этой секции, вида ::ffff:192.0.2.0. Например, 2001:0::0:01 будет преобразован к 2001::1, а ::ffff:0a0a:0a0a к ::ffff:10.10.10.10. Все символы преобразуются в нижний регистр.

Принимает два необязательных аргумента:

protocol¶: Ограничивает диапазон значений указанным протоколом. Принимает значения: both (по умолчанию, т.е. “оба”), IPv4 или IPv6. Регистр букв не имеет значения.

unpack_ipv4¶: Распаковывает IPv4 адреса вида ::ffff::192.0.2.1. Если эта опция активирована, то адрес будет преобразован в 192.0.2.1. По умолчанию опция отключена. Может использоваться только если protocol установлен в 'both'.

`MultipleChoiceField`¶

class MultipleChoiceField(**kwargs)¶

Стандартный виджет: SelectMultiple.
Пустое значение: [] (пустой список).
Возвращает: Список объектов Unicode.
Проверяет, что каждое значение из полученного списка присутствует в списке вариантов.
Ключи сообщений об ошибках: required, invalid_choice, invalid_list.

Сообщение об ошибке invalid_choice может содержать %(value)s, которое будет замещено выбранным вариантом.

Принимает один дополнительный обязательный аргумент choices, аналогично полю ChoiceField.

`TypedMultipleChoiceField`¶

Добавлено в Django 1.3: Пожалуйста, обратитесь к описанию релиза

class TypedMultipleChoiceField(**kwargs)¶

Похоже на MultipleChoiceField, за исключением того, что TypedMultipleChoiceField принимает два дополнительных аргумента: coerce и empty_value.

Стандартный виджет: SelectMultiple.
Пустое значение: Всё, что вы назовёте empty_value.
Возвращает: Список значений типа, который указан аргументом coerce.
Проверяет, что полученные значения присутствуют в списке вариантов и могут быть преобразованы в нужный тип.
Ключи сообщений об ошибках: required, invalid_choice.

Сообщение об ошибке invalid_choice может содержать %(value)s, которое будет замещено выбранным вариантом.

Принимает два дополнительных аргумента, coerce и empty_value, аналогично TypedChoiceField.

`NullBooleanField`¶

class NullBooleanField(**kwargs)¶

Стандартный виджет: NullBooleanSelect.
Пустое значение: None.
Возвращает: True, False или None.
Ничего не проверяет, т.е. никогда не возвратит ValidationError.

`RegexField`¶

class RegexField(**kwargs)¶

Стандартный виджет: TextInput.
Пустое значение: '' (пустая строка).
Возвращает: Объект Unicode.
Проверяет, что полученное значение совпадает с указанным регулярным выражением.
Ключи сообщений об ошибках: required, invalid.

Принимает один обязательный аргумент:

regex¶: Регулярное выражение в виде строки или скомпилированного объекта регулярного выражения.

Также принимает аргументы max_length и min_length, которые работают аналогично CharField.

Необязательный аргумент error_message принимается в целях обратной совместимости. Предпочтительным способом указания собственного сообщения об ошибке является использование аргумента error_messages, которому назначается словарь с ключём invalid.

`SlugField`¶

class SlugField(**kwargs)¶

Стандартный виджет: TextInput.
Пустое значение: '' (пустая строка).
Возвращает: Объект Unicode.
Проверяет, что полученное значение содержит только буквы, цифры, подчёркивания и тире.
Ключи сообщений об ошибках: required, invalid.

Это поле предназначено для представления поля модели SlugField на формах.

`TimeField`¶

class TimeField(**kwargs)¶

Стандартный виджет: TextInput.
Пустое значение: None.
Возвращает: Объект datetime.time языка Python.
Проверяет, что переданное значение является объектом datetime.time или строкой, отформатированной в нужном виде.
Ключи сообщений об ошибках: required, invalid.

Принимает один необязательный аргумент:

input_formats¶: Список форматов, используемых при попытках сконвертировать строку в объект datetime.time.

Если аргумент input_formats не предоставлен, то используются следующие форматы:

'%H:%M:%S',     # '14:30:59'
'%H:%M',        # '14:30'

`URLField`¶

class URLField(**kwargs)¶

Стандартный виджет: TextInput.
Пустое значение: '' (пустая строка).
Возвращает: Объект Unicode.
Проверяет, что полученное значение является правильным URL.
Ключи сообщений об ошибках: required, invalid, invalid_link.

Принимает следующие необязательные аргументы:

max_length¶

min_length¶

Аналогичны CharField.max_length и``CharField.min_length``.

verify_exists¶: Если True, то производится проверка работоспособности полученного URL. В случае недоступности ресурса (т.е., получен ответ 404), вызывается исключение ValidationError. Значение по умолчанию False.

Устарело в Django 1.4: verify_exists was deprecated for security reasons and will be removed in Django 1.5. This deprecation also removes validator_user_agent.

validator_user_agent¶: Строка, используемая в качестве идентификатора браузера при проверке URL. По умолчанию равна значению URL_VALIDATOR_USER_AGENT.

Изменено в Django 1.2: The URLField previously did not recognize URLs as valid that contained an IDN (Internationalized Domain Name; a domain name containing unicode characters) domain name. This has now been corrected.

Достаточно сложные встроенные классы `Field`¶

`ComboField`¶

class ComboField(**kwargs)¶

Стандартный виджет: TextInput.
Пустое значение: '' (пустая строка).
Возвращает: Объект Unicode.
Проверяет, что полученное значение соответствует каждому полю, указанному в качестве аргумента ComboField.
Ключи сообщений об ошибках: required, invalid.

Принимает один дополнительный обязательный аргумент:

fields¶

Список полей, которые должны использоваться для проверки значения поля (в порядке их определения).

>>> f = ComboField(fields=[CharField(max_length=20), EmailField()])
>>> f.clean('test@example.com')
u'test@example.com'
>>> f.clean('longemailaddress@example.com')
Traceback (most recent call last):
...
ValidationError: [u'Ensure this value has at most 20 characters (it has 28).']

`MultiValueField`¶

class MultiValueField(**kwargs)¶

Стандартный виджет: TextInput.
Пустое значение: '' (пустая строка).
Возвращает: Тип, который вернёт метод compress().
Проверяет, что полученное значение соответствует полям, указанным в аргументе MultiValueField.
Ключи сообщений об ошибках: required, invalid.

Это абстрактное поле (от него следует наследовать свои поля) объединяет логику нескольких полей. Дочерние классы не должны реализовывать метод clean(). Вместо этого, они должны предоставлять метод compress(), который принимает список проверенных значений и возвращает “сжатую” версию этих данных в виде одного значения. Например, класс SplitDateTimeField является дочерним классом этого поля, который объединяет поля даты и времени в единый объект даты-времени.

Принимает один дополнительный обязательный аргумент:

fields¶: Список полей, которые объединяются в единственное поле. Каждое значение в свойстве clean проверено соответствующим полем в fields. Первое значение обрабатывается первым полем, второе – вторым и так далее. После проверки всех полей, список значений “сжимается” в одно значений.

`SplitDateTimeField`¶

class SplitDateTimeField(**kwargs)¶

Стандартный виджет: SplitDateTimeWidget.
Пустое значение: None.
Возвращает: Объект datetime.datetime языка Python.
Проверяет, что переданное значение является объектом datetime.datetime или строкой, отформатированной в нужном виде.
Ключи сообщений об ошибках: required, invalid, invalid_date, invalid_time.

Принимает два необязательных аргумента:

input_date_formats¶: Список форматов, используемых при попытках сконвертировать строку в объект datetime.date.

Если аргумент input_date_formats не был предоставлен, то используются шаблоны аналогичные полю DateField.

input_time_formats¶: Список форматов, используемых при попытках сконвертировать строку в объект datetime.time.

Если аргумент input_date_formats не был предоставлен, то используются шаблоны аналогичные полю TimeField.

Поля для обработки связей¶

Для представления связей между моделями предлагается два поля: ModelChoiceField and ModelMultipleChoiceField. Оба эти поля требуют наличие одного параметра queryset, который используется для создания вариантов значений для этого поля. При проверке формы эти поля заполняются одним объектом модели (в случае ModelChoiceField) или множеством объектов модели (в случае ModelMultipleChoiceField) в словаре cleaned_data формы.

`ModelChoiceField`¶

class ModelChoiceField(**kwargs)¶

Стандартный виджет: Select.
Пустое значение: None.
Возвращает: Экземпляр модели.
Проверяет, что полученный идентификатор присутствует в выборке.
Ключи сообщений об ошибках: required, invalid_choice.

Позволяет выбрать единственный объект модели. Подходит для представления внешнего ключа. Обязательный аргумент:

queryset¶: Объект QuerySet содержит выборку объектов модели, которые являются значениями для этого поля и которые будут использоваться для проверки полученных данных.

``ModelChoiceField``принимает один необязательный аргумент:

empty_label¶

По умолчанию виджет <select>, используемый полем ModelChoiceField, содержит пустой вариант в начале списка. Вы можете изменить текстовую метку для этого варианта (по умолчанию это "---------") с помощью атрибута empty_label. Также вы можете исключить пустой вариант из списка поря, назначив None параметру empty_label:

# A custom empty label
field1 = forms.ModelChoiceField(queryset=..., empty_label="(Nothing)")

# No empty label
field2 = forms.ModelChoiceField(queryset=..., empty_label=None)

Следует отметить, что если ModelChoiceField является обязательным и имеет начальное значение, то пустой вариант отсутствует для такого поля, вне зависимости от значения аргумента empty_label.

При генерации текстового представления варианта используется метод __unicode__ модели. Для получения собственного представления, следует унаследовать ModelChoiceField и переопределить метод label_from_instance. Этот метод получает объект модели и должен возвратить соответствующую строку. Например:

class MyModelChoiceField(ModelChoiceField):
    def label_from_instance(self, obj):
        return "My Object #%i" % obj.id

`ModelMultipleChoiceField`¶

class ModelMultipleChoiceField(**kwargs)¶

Стандартный виджет: SelectMultiple.
Пустое значение: [] (пустой список).
Возвращает: Список экземпляров модели.
Проверяет, что каждый идентификатор полученного списка значений присутствует в выборке.
Ключи сообщений об ошибках: required, list, invalid_choice, invalid_pk_value.

Позволяет выбрать один или несколько объектов модели. Подходит для представления отношения “многие-ко-многим”. Аналогично ModelChoiceField, вы можете использовать label_from_instance для управления текстовым представлением объекта. Параметр queryset является обязательным:

queryset¶: Объект QuerySet содержит выборку объектов модели, которые являются значениями для этого поля и которые будут использоваться для проверки полученных данных.

Создание собственных полей¶

Если встроенные классы Field не подходят к вашей задаче, вы легко можете создать свои собственные. Для того, чтобы сделать это просто унаследуйте ваш класс от django.forms.Field. Класс должен реализовывать метод clean() и его конструктор должен принимать обязательные аргументы, т.е., required, label, initial, widget, help_text.

Django 1.4 documentation (читать 1.5)

Поля формы¶

Базовые аргументы поля¶

required¶

label¶

initial¶

widget¶

help_text¶

error_messages¶

validators¶

localize¶

Классы встроенных полей¶

BooleanField¶

CharField¶

ChoiceField¶

TypedChoiceField¶

DateField¶

DateTimeField¶

DecimalField¶

EmailField¶

FileField¶

FilePathField¶

FloatField¶

ImageField¶

IntegerField¶

IPAddressField¶

GenericIPAddressField¶

MultipleChoiceField¶

TypedMultipleChoiceField¶

NullBooleanField¶

RegexField¶

SlugField¶

TimeField¶

URLField¶

Достаточно сложные встроенные классы Field¶

ComboField¶

MultiValueField¶

SplitDateTimeField¶

Поля для обработки связей¶

ModelChoiceField¶

ModelMultipleChoiceField¶

Создание собственных полей¶

Содержание

Browse

You are here:

На этой странице

Быстрый поиск

Последнее обновление:

РљРѕРјРјРµРЅС‚Р°СЂРёРё

`required`¶

`label`¶

`initial`¶

`widget`¶

`help_text`¶

`error_messages`¶

`validators`¶

`localize`¶

`BooleanField`¶

`CharField`¶

`ChoiceField`¶

`TypedChoiceField`¶

`DateField`¶

`DateTimeField`¶

`DecimalField`¶

`EmailField`¶

`FileField`¶

`FilePathField`¶

`FloatField`¶

`ImageField`¶

`IntegerField`¶

`IPAddressField`¶

`GenericIPAddressField`¶

`MultipleChoiceField`¶

`TypedMultipleChoiceField`¶

`NullBooleanField`¶

`RegexField`¶

`SlugField`¶

`TimeField`¶

`URLField`¶

Достаточно сложные встроенные классы `Field`¶

`ComboField`¶

`MultiValueField`¶

`SplitDateTimeField`¶

`ModelChoiceField`¶

`ModelMultipleChoiceField`¶