PostgreSQL 特有表单字段和部件Link to this heading#

SimpleArrayFieldLink to this heading#

class SimpleArrayField(base_field, delimiter=',', max_length=None, min_length=None)Link to this definition#

一个映射到数组的字段。它由一个 HTML <input> 表示。

base_fieldLink to this definition#

这是一个必要的参数。

它指定了数组的基础表单字段。这不用于呈现任何 HTML，但用于处理提交的数据并验证它。例如：

Python console

>>> from django import forms
>>> from django.contrib.postgres.forms import SimpleArrayField

>>> class NumberListForm(forms.Form):
...     numbers = SimpleArrayField(forms.IntegerField())
...

>>> form = NumberListForm({"numbers": "1,2,3"})
>>> form.is_valid()
True
>>> form.cleaned_data
{'numbers': [1, 2, 3]}

>>> form = NumberListForm({"numbers": "1,2,a"})
>>> form.is_valid()
False

delimiterLink to this definition#

这是一个可选参数，默认为逗号：,。这个值用于分隔提交的数据。它允许你链式使用 SimpleArrayField 来处理多维数据：

Python console

>>> from django import forms
>>> from django.contrib.postgres.forms import SimpleArrayField

>>> class GridForm(forms.Form):
...     places = SimpleArrayField(SimpleArrayField(IntegerField()), delimiter="|")
...

>>> form = GridForm({"places": "1,2|2,1|4,3"})
>>> form.is_valid()
True
>>> form.cleaned_data
{'places': [[1, 2], [2, 1], [4, 3]]}

max_lengthLink to this definition#

这是一个可选的参数，用于验证数组的长度是否超过了规定的长度。

min_lengthLink to this definition#

这是一个可选的参数，用于验证数组是否至少达到了指定的长度。

SplitArrayFieldLink to this heading#

class SplitArrayField(base_field, size, remove_trailing_nulls=False)Link to this definition#

这个字段通过重现底层字段固定的次数来处理数组。

base_fieldLink to this definition#

这是一个必要的参数。它指定了要重复的表单字段。

sizeLink to this definition#

这是基础字段的固定使用次数。

remove_trailing_nullsLink to this definition#

默认情况下，这被设置为 False。当 False 时，重复字段的每个值都会被存储。当设置为 True 时，任何尾部为空白的值将从结果中删除。如果底层字段有 required=True，但 remove_trailing_nulls 是 True，那么只有在最后才允许有空值，并且空值会被消除。

一些例子：

Code

SplitArrayField(IntegerField(required=True), size=3, remove_trailing_nulls=False)

["1", "2", "3"]  # -> [1, 2, 3]
["1", "2", ""]  # -> ValidationError - third entry required.
["1", "", "3"]  # -> ValidationError - second entry required.
["", "2", ""]  # -> ValidationError - first and third entries required.

SplitArrayField(IntegerField(required=False), size=3, remove_trailing_nulls=False)

["1", "2", "3"]  # -> [1, 2, 3]
["1", "2", ""]  # -> [1, 2, None]
["1", "", "3"]  # -> [1, None, 3]
["", "2", ""]  # -> [None, 2, None]

SplitArrayField(IntegerField(required=True), size=3, remove_trailing_nulls=True)

["1", "2", "3"]  # -> [1, 2, 3]
["1", "2", ""]  # -> [1, 2]
["1", "", "3"]  # -> ValidationError - second entry required.
["", "2", ""]  # -> ValidationError - first entry required.

SplitArrayField(IntegerField(required=False), size=3, remove_trailing_nulls=True)

["1", "2", "3"]  # -> [1, 2, 3]
["1", "2", ""]  # -> [1, 2]
["1", "", "3"]  # -> [1, None, 3]
["", "2", ""]  # -> [None, 2]

HStoreFieldLink to this heading#

class HStoreFieldLink to this definition#

一个为 HStoreField 接受 JSON 编码数据的字段。它将所有的值（除了空值）转换为字符串。它由一个 HTML <textarea> 表示。

范围字段Link to this heading#

这组字段在接受范围数据方面都有类似的功能。它们基于 MultiValueField。它们将一个省略的值视为一个无边界的范围。它们还验证了下限不大于上限。所有这些字段都使用 RangeWidget。

RangeWidgetLink to this heading#

class RangeWidget(base_widget, attrs=None)Link to this definition#

所有范围字段都使用的部件。基于 MultiWidget。

RangeWidget 有一个必要的参数：

base_widgetLink to this definition#

一个 RangeWidget 由 base_widget 的二元元组组成。

decompress(value)Link to this definition#

取一个字段的单个“压缩”值，例如一个 DateRangeField，并返回一个元组，代表一个下界和上界。