Alla dessa fält och widgets är tillgängliga från modulen django.contrib.postgres.forms.
SimpleArrayFieldLink to this heading#Ett fält som mappar till en array. Det representeras av en HTML <input>.
Detta är ett nödvändigt argument.
\nDet anger det underliggande formulärfältet för arrayen. Detta används inte för att rendera någon HTML, men det används för att bearbeta de inskickade uppgifterna och validera dem. Ett exempel:
\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\nDetta är ett valfritt argument som i standardfallet är ett kommatecken: ,. Detta värde används för att dela upp de data som skickas in. Det gör att du kan kedja SimpleArrayField för flerdimensionella data:
>>> 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]]}\nDetta är ett valfritt argument som validerar att matrisen inte överstiger den angivna längden.
\nDetta är ett valfritt argument som validerar att matrisen når minst den angivna längden.
\nSplitArrayFieldLink to this heading#Detta fält hanterar matriser genom att reproducera det underliggande fältet ett fast antal gånger.
\nDetta är ett obligatoriskt argument. Det anger det formulärfält som ska upprepas.
\nDetta är det fasta antal gånger som det underliggande fältet kommer att användas.
\nSom standard är detta inställt på False. När False, lagras varje värde från de upprepade fälten. När den är inställd på True kommer alla efterföljande värden som är tomma att tas bort från resultatet. Om det underliggande fältet har required=True, men remove_trailing_nulls är True, är null-värden endast tillåtna i slutet och kommer att tas bort.
Några exempel:
\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#Ett fält som accepterar JSON-kodade data för en HStoreField. Det kastar alla värden (utom nulls) till strängar. Det representeras av en HTML <textarea>.
Denna grupp av fält delar alla liknande funktionalitet för att acceptera intervalldata. De är baserade på MultiValueField. De behandlar ett utelämnat värde som ett obegränsat intervall. De validerar också att den nedre gränsen inte är större än den övre gränsen. Alla dessa fält använder RangeWidget.
IntegerRangeFieldLink to this heading#Baserat på IntegerField och översätter dess indata till django.db.backends.postgresql.psycopg_any.NumericRange. Standard för IntegerRangeField och BigIntegerRangeField.
DecimalRangeFieldLink to this heading#Baserad på DecimalField och översätter dess indata till django.db.backends.postgresql.psycopg_any.NumericRange. Standard för DecimalRangeField.
DatumTimeRangeFieldLink to this heading#Baserad på DateTimeField och översätter dess indata till django.db.backends.postgresql.psycopg_any.DateTimeTZRange. Standard för DateTimeRangeField.
DatumintervallfältLink to this heading#Baserat på DateField och översätter dess indata till django.db.backends.postgresql.psycopg_any.DateRange. Standard för DateRangeField.
RangeWidgetLink to this heading#Widget som används av alla fält i intervallet. Baserat på MultiWidget.
RangeWidget har ett obligatoriskt argument:
En RangeWidget består av en 2-tupel av base_widget.
Tar ett enda ”komprimerat” värde för ett fält, t.ex. ett DateRangeField, och returnerar en tupel som representerar en nedre och övre gräns.