djangodocs

Django 6.1
Gaeilge
Documentation contents

Réimsí foirme agus giuirléidí sonracha PostgreSQL

Tá na réimsí agus na giuirléidí seo go léir ar fáil ón modúl django.contrib.postgres.forms.

Réimsí

Simplearrayfield

class SimpleArrayField(base_field, delimiter=',', max_length=None, min_length=None)

Réimse a dhéanann mapáil chuig eagar. Léirítear é ag HTML <input>```.

base_field

Is argóint riachtanach é seo.

Sonraíonn sé an réimse foirme bhunúsach don eagar. Ní úsáidtear é seo chun aon HTML a rinneadh, ach úsáidtear é chun na sonraí a chuirtear isteach a phróiseáil agus iad a bhailíochtú. Mar shampla:

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
delimiter

Is argóint roghnach é seo a réamhshocraíonn camóg: ,. Úsáidtear an luach seo chun na sonraí curtha isteach a roinnt. Ligeann sé duit ``SimpleArrayField` a shlánú le haghaidh sonraí ilthoiseach:

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_length

Is argóint roghnach é seo a bhailíochtaíonn nach sáraíonn an tsraith an fad luaite.

min_length

Is argóint roghnach é seo a bhailíochtaíonn go sroicheann an t-eagar an fad luaite ar a laghad.

SplitarrayField

class SplitArrayField(base_field, size, remove_trailing_nulls=False)

Láimhseálann an réimse seo eagair tríd an réimse bunúsach a atáirgeadh líon seasta uaireanta

base_field

Is argóint riachtanach é seo. Sonraíonn sé an réimse foirme atá le hathdhéanamh arís.

size

Is é seo an líon seasta uaireanta a úsáidfear an réimse bunúsach.

remove_trailing_nulls

De réir réamhshocraithe, tá sé seo socraithe go False. Nuair a bhíonn “False”, stóráiltear gach luach ó na réimsí arís agus arís eile. Nuair a bheidh sé socraithe go “True”, bainfear aon luachanna rianacha atá bán as an toradh. Má tá required=True sa réimse bunúsach, ach is é `True remove_trailing_nulls`, ansin ní cheadaítear luachanna null ach ag an deireadh, agus scriosfar iad.

Roinnt samplaí:

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]

HStorefield

class HStoreField

Réimse a ghlacann le sonraí ionchódaithe JSON le haghaidh an:class: ~django.contrib.postgres.fields.hStoreField. Caitheann sé gach luach (seachas neamhaill) chuig teaghráin. Léirítear é ag HTML <textarea>```.

Réimsí Raon

Tá feidhmiúlacht chosúil ag an ngrúpa réimsí seo go léir chun glacadh le sonraí ra Tá siad bunaithe ar:class: ~django.forms.MultivalueField. Déileálann siad le luach amháin a fhágtar amach mar raon neamhtheoranta. Bailíonn siad freisin nach bhfuil an teorainn íochtarach níos mó ná an teorainn uachtarach. Úsáideann na réimsí seo go léir:class: ~django.contrib.postgres.forms.rangeWidget.

Réimse Iomlána

class IntegerRangeField

Bunaithe ar:class: ~django.forms.IntegerField agus aistríonn a ionchur go django.db.backends.postgresql.psycopg_any.numericRange. Réamhshocraithe le haghaidh: aicme: ~django.contrib.postgres.fields.IntegerRangeField agus:class: ~django.contrib.postgres.fields.bigintegerRangeField.

Deimalrangefield

class DecimalRangeField

Bunaithe ar:class: ~Django.Forms.DecimalField agus aistríonn a ionchur go django.db.backends.postgresql.psycopg_any.numericRange. Réamhshocraithe le haghaidh: aicme: ~django.contrib.postgres.fields.DecimalRangeField.

DataTimerangeField

class DateTimeRangeField

Bunaithe ar:class: ~django.forms.DateTimeField agus aistríonn a ionchur go django.db.backends.postgresql.psycopg_any.DateTimetzRange. Réamhshocraithe le haghaidh: aicme: ~django.contrib.postgres.fields.dateTimeRangeField.

Daterangefield

class DateRangeField

Bunaithe ar:class: ~Django.Forms.DateField agus aistríonn a ionchur go Django.db.backends.postgresql.psycopg_any.daterange. Réamhshocraithe le haghaidh: aicme: ~django.contrib.postgres.fields.DateRangeField.

Giuirléidí

RangeWidget

class RangeWidget(base_widget, attrs=None)

Giuirléid a úsáideann gach ceann de na réimsí raon. Bunaithe ar:aicme: ~django.forms.multiwidget.

RangeWidget has one required argument:

base_widget

A: Aicme: Cuimsíonn ~ RangeWidget 2-tuple de base_widget.

decompress(value)

Tógann sé luach amháin “comhbhrúite” de réimse, mar shampla a:class: ~django.contrib.postgres.fields.DateRangeField, agus filleann sé tuipéar a léiríonn ceann íochtarach agus uachtarach.

View as Markdown Edit this page on GitHub Official version