これらのフィールドやウィジェットはすべて django.contrib.postgres.forms モジュールから利用できます。
SimpleArrayFieldLink to this heading#配列にマップされるフィールド。HTMLの <input> で表されます。
これは必須の引数です。
\n配列のもととなるフォームフィールドを指定します。これは HTML のレンダリングには使われませんが、送信されたデータを処理し、それを検証するために使われます。たとえば:
\n>>> from django import forms\n>>> from django.contrib.postgres.forms import SimpleArrayField\n\n>>> class NumberListForm(forms.Form):\n... numbers = SimpleArrayField(forms.IntegerField())\n...\n\n>>> form = NumberListForm({"numbers": "1,2,3"})\n>>> form.is_valid()\nTrue\n>>> form.cleaned_data\n{'numbers': [1, 2, 3]}\n\n>>> form = NumberListForm({"numbers": "1,2,a"})\n>>> form.is_valid()\nFalse\nこれはオプションの引数で、デフォルトはコンマ , です。この値は送信されたデータを分割するために使用されます。多次元データに対して SimpleArrayField を連結できます:
>>> from django import forms\n>>> from django.contrib.postgres.forms import SimpleArrayField\n\n>>> class GridForm(forms.Form):\n... places = SimpleArrayField(SimpleArrayField(IntegerField()), delimiter="|")\n...\n\n>>> form = GridForm({"places": "1,2|2,1|4,3"})\n>>> form.is_valid()\nTrue\n>>> form.cleaned_data\n{'places': [[1, 2], [2, 1], [4, 3]]}\nこれはオプションの引数で、配列が指定された長さを超えていないことを検証します。
\nこれはオプションの引数で、配列が少なくとも指定された長さに達していることを検証します。
\nSplitArrayFieldLink to this heading#このフィールドは、ベースとなるフィールドを固定回数複製することで配列を処理します。
\nこれは必須の引数です。繰り返すフォームフィールドを指定します。
\nこれは、ベースとなるフィールドが使用される固定の回数です。
\nデフォルトでは False に設定されています。 False に設定すると、繰り返されたフィールドのそれぞれの値が保存されます。 True に設定すると、末尾の値が空白の場合、その値は結果から取り除かれます。基となるフィールドが required=True で、かつ remove_trailing_nulls が True の場合、末尾にのみ null 値が許され、その値は取り除かれます。
例:
\nSplitArrayField(IntegerField(required=True), size=3, remove_trailing_nulls=False)\n\n["1", "2", "3"] # -> [1, 2, 3]\n["1", "2", ""] # -> ValidationError - third entry required.\n["1", "", "3"] # -> ValidationError - second entry required.\n["", "2", ""] # -> ValidationError - first and third entries required.\n\nSplitArrayField(IntegerField(required=False), size=3, remove_trailing_nulls=False)\n\n["1", "2", "3"] # -> [1, 2, 3]\n["1", "2", ""] # -> [1, 2, None]\n["1", "", "3"] # -> [1, None, 3]\n["", "2", ""] # -> [None, 2, None]\n\nSplitArrayField(IntegerField(required=True), size=3, remove_trailing_nulls=True)\n\n["1", "2", "3"] # -> [1, 2, 3]\n["1", "2", ""] # -> [1, 2]\n["1", "", "3"] # -> ValidationError - second entry required.\n["", "2", ""] # -> ValidationError - first entry required.\n\nSplitArrayField(IntegerField(required=False), size=3, remove_trailing_nulls=True)\n\n["1", "2", "3"] # -> [1, 2, 3]\n["1", "2", ""] # -> [1, 2]\n["1", "", "3"] # -> [1, None, 3]\n["", "2", ""] # -> [None, 2]\nHStoreFieldLink to this heading#HStoreField 向けにJSONエンコードされたデータを受け付けるフィールドです。全ての値 (nullを除く) を文字列にキャストします。HTMLの <textarea> で表現されます。
このグループのフィールドは、範囲データを受け取るための同様の機能を共有しています。これらは MultiValueField に基づいています。これらのフィールドは、1つの省略された値を境界のない範囲として扱います。また、下限値が上限値より大きくないことを検証します。これらのフィールドは全て RangeWidget を使用しています。
IntegerRangeFieldLink to this heading#IntegerField に基づいて、入力を django.db.backends.postgresql.psycopg_any.NumericRange に変換します。 IntegerRangeField と BigIntegerRangeField のデフォルトです。
DecimalRangeFieldLink to this heading#DecimalField に基づいて、その入力を django.db.backends.postgresql.psycopg_any.NumericRange に変換します。 DecimalRangeField のデフォルトです。
DateTimeRangeFieldLink to this heading#DateTimeField クラスに基づいて、その入力を django.db.backends.postgresql.psycopg_any.DateTimeTZRange に変換します。これは DateTimeRangeField のデフォルトです。
DateRangeFieldLink to this heading#DateField に基づいて、その入力を django.db.backends.postgresql.psycopg_any.DateRange に変換します。 これは DateRangeField のデフォルトです。
RangeWidgetLink to this heading#すべての範囲フィールドで使用されるウィジェット。 MultiWidget を基にしています。
RangeWidget は1つの必須引数を持ちます:
RangeWidget は、base_widget の 2値タプルを構成します。
例えば DateRangeField のようなフィールドの "圧縮された" 値を一つ受け取り、下界と上界を表すタプルを返します。