---
title: "Bidang formulir khusus PostgreSQL dan widget"
version: 4.0
locale: id
source: https://docs.djangoproject.com/id/4.0/ref/contrib/postgres/forms/
canonical: https://djangodocs.dev/id/4.0/ref/contrib/postgres/forms/
---
# Bidang formulir khusus PostgreSQL dan widget
Semua bidang ini dan widget tersedia dari modul `django.contrib.postgres.forms`.
## Bidang
### `SimpleArrayField`
#### `class SimpleArrayField(base_field, delimiter=',', max_length=None, min_length=None)`
A field which maps to an array. It is represented by an HTML ``.
#### `base_field`
Ini adalah sebuah argumen diwajibkan.
Itu menentukan bidang formulir pokok untuk larik. Ini tidak digunakan untuk membangun HTML apapun, tetapi itu digunakan untuk mengolah data terajukan dan mensahkan itu. Sebagai contoh:
```
>>> 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`
Ini adalah sebuah argumen pilihan yang awalan pada koma: `,`. Nilai ini digunakan untuk memisahkan data terajukan. Itu mengizinkan anda mengikat `SimpleArrayField` untuk data multi dimensi:
```
>>> 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]]}
```
> **Note**
>
> Bidang tidak mendukung pelolosan dari pembatas, jadi waspada dalam kasus dimana pembatas adalah karakter sah dalam bidang pokok. Pembatas tidak perlu hanya satu karakter saja.
#### `max_length`
Ini adalah argumen pilihan yang mensahkan bahwa senaraitidak melampaui panjang yang dinyatakan.
#### `min_length`
Ini adalah argumen pilihan yang mensahkan bahwa senarai mencapai setidaknya panjang yang dinyatakan.
> **Formulir ramah**
>
> `SimpleArrayField` tidak terlalu ramah dalam kebanyakan kasus, bagaimanapun itu adalah cara berguna untuk membentuk data dari widget sisi-klien untuk pengajuan ke peladen.
### `SplitArrayField`
#### `class SplitArrayField(base_field, size, remove_trailing_nulls=False)`
Bidang ini menangani larik dengan membuat kembali bidang pokok tetap beberapa kali.
#### `base_field`
Ini adalah argumen diwajibkan. Itu menentukan bidang formulir untuk diulang.
#### `size`
Ini adalah nomor tetap dari berkali-kali bidang pokok akan digunakan.
#### `remove_trailing_nulls`
Secara awalan, ini disetel menjadi `False`. Ketika `False`, setiap nilai dari bdiang-bidang terulang disimpan. Ketika disetel menjadi `True`, nilai-nilai apapun yang membuntuti yang merupakan kosong akan dihilangkan dari hasil. Jika bidang pokok mempunyai `required=True`, tetapi `remove_trailing_nulls` adalah `True`, kemudian nilai-nilai null hanya diijinkan pada akhir, dan akan dihilangkan.
Beberapa contoh:
```
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`
Sebuah bidang yang menerima data tersandikan JSON untuk sebuah [`HStoreField`](/id/4.0/ref/contrib/postgres/fields/#django.contrib.postgres.fields.HStoreField). Itu melemparkan semua nilai (kecuali null) ke string. Itu diwakili oleh sebuah HTML `