{"title":"PostgreSQL 特有表单字段和部件","version":"4.2","locale":"zh-hans","docname":"ref/contrib/postgres/forms","url":"/zh-hans/4.2/ref/contrib/postgres/forms/","canonical":"https://djangodocs.dev/zh-hans/4.2/ref/contrib/postgres/forms/","summary":"所有这些字段和部件都可以从 django.contrib.postgres.forms 模块中获得。 字段 Link to this heading # SimpleArrayField Link to this heading # class SimpleArrayField ( base_field , delimiter…","html":"<h1>PostgreSQL 特有表单字段和部件<a class=\"heading-anchor\" href=\"#postgresql-specific-form-fields-and-widgets\"><span class=\"visually-hidden\">Link to this heading</span><span aria-hidden=\"true\">#</span></a></h1>\n<p>所有这些字段和部件都可以从 <code class=\"docutils literal notranslate\"><span class=\"pre\">django.contrib.postgres.forms</span></code> 模块中获得。</p>\n<section id=\"fields\">\n<h2>字段<a class=\"heading-anchor\" href=\"#fields\"><span class=\"visually-hidden\">Link to this heading</span><span aria-hidden=\"true\">#</span></a></h2>\n<section id=\"simplearrayfield\">\n<h3><code class=\"docutils literal notranslate\"><span class=\"pre\">SimpleArrayField</span></code><a class=\"heading-anchor\" href=\"#simplearrayfield\"><span class=\"visually-hidden\">Link to this heading</span><span aria-hidden=\"true\">#</span></a></h3>\n<dl class=\"py class\">\n<dt class=\"sig sig-object py\" id=\"django.contrib.postgres.forms.SimpleArrayField\">\n<em class=\"property\"><span class=\"k\"><span class=\"pre\">class</span></span><span class=\"w\"> </span></em><span class=\"sig-name descname\"><span class=\"pre\">SimpleArrayField</span></span><span class=\"sig-paren\">(</span><em class=\"sig-param\"><span class=\"n\"><span class=\"pre\">base_field</span></span></em>, <em class=\"sig-param\"><span class=\"n\"><span class=\"pre\">delimiter</span></span><span class=\"o\"><span class=\"pre\">=</span></span><span class=\"default_value\"><span class=\"pre\">','</span></span></em>, <em class=\"sig-param\"><span class=\"n\"><span class=\"pre\">max_length</span></span><span class=\"o\"><span class=\"pre\">=</span></span><span class=\"default_value\"><span class=\"pre\">None</span></span></em>, <em class=\"sig-param\"><span class=\"n\"><span class=\"pre\">min_length</span></span><span class=\"o\"><span class=\"pre\">=</span></span><span class=\"default_value\"><span class=\"pre\">None</span></span></em><span class=\"sig-paren\">)</span><a class=\"heading-anchor\" href=\"#django.contrib.postgres.forms.SimpleArrayField\"><span class=\"visually-hidden\">Link to this definition</span><span aria-hidden=\"true\">#</span></a></dt>\n<dd><p>一个映射到数组的字段。它由一个 HTML <code class=\"docutils literal notranslate\"><span class=\"pre\">&lt;input&gt;</span></code> 表示。</p>\n<dl class=\"py attribute\">\n<dt class=\"sig sig-object py\" id=\"django.contrib.postgres.forms.SimpleArrayField.base_field\">\n<span class=\"sig-name descname\"><span class=\"pre\">base_field</span></span><a class=\"heading-anchor\" href=\"#django.contrib.postgres.forms.SimpleArrayField.base_field\"><span class=\"visually-hidden\">Link to this definition</span><span aria-hidden=\"true\">#</span></a></dt>\n<dd><p>这是一个必要的参数。</p>\n<p>它指定了数组的基础表单字段。这不用于呈现任何 HTML，但用于处理提交的数据并验证它。例如：</p>\n<div class=\"code-block\" data-language=\"pycon\"><div class=\"code-block-toolbar\"><span class=\"code-block-language\">Python console</span><button type=\"button\" class=\"copy-button\" data-copy hidden><span class=\"copy-button-label\">Copy</span></button></div><pre role=\"group\" tabindex=\"0\" aria-label=\"Python console code\"><code><span class=\"gp\">&gt;&gt;&gt; </span><span class=\"kn\">from</span><span class=\"w\"> </span><span class=\"nn\">django</span><span class=\"w\"> </span><span class=\"kn\">import</span> <span class=\"n\">forms</span>\n<span class=\"gp\">&gt;&gt;&gt; </span><span class=\"kn\">from</span><span class=\"w\"> </span><span class=\"nn\">django.contrib.postgres.forms</span><span class=\"w\"> </span><span class=\"kn\">import</span> <span class=\"n\">SimpleArrayField</span>\n\n<span class=\"gp\">&gt;&gt;&gt; </span><span class=\"k\">class</span><span class=\"w\"> </span><span class=\"nc\">NumberListForm</span><span class=\"p\">(</span><span class=\"n\">forms</span><span class=\"o\">.</span><span class=\"n\">Form</span><span class=\"p\">):</span>\n<span class=\"gp\">... </span>    <span class=\"n\">numbers</span> <span class=\"o\">=</span> <span class=\"n\">SimpleArrayField</span><span class=\"p\">(</span><span class=\"n\">forms</span><span class=\"o\">.</span><span class=\"n\">IntegerField</span><span class=\"p\">())</span>\n<span class=\"gp\">...</span>\n\n<span class=\"gp\">&gt;&gt;&gt; </span><span class=\"n\">form</span> <span class=\"o\">=</span> <span class=\"n\">NumberListForm</span><span class=\"p\">({</span><span class=\"s2\">&quot;numbers&quot;</span><span class=\"p\">:</span> <span class=\"s2\">&quot;1,2,3&quot;</span><span class=\"p\">})</span>\n<span class=\"gp\">&gt;&gt;&gt; </span><span class=\"n\">form</span><span class=\"o\">.</span><span class=\"n\">is_valid</span><span class=\"p\">()</span>\n<span class=\"go\">True</span>\n<span class=\"gp\">&gt;&gt;&gt; </span><span class=\"n\">form</span><span class=\"o\">.</span><span class=\"n\">cleaned_data</span>\n<span class=\"go\">{&#39;numbers&#39;: [1, 2, 3]}</span>\n\n<span class=\"gp\">&gt;&gt;&gt; </span><span class=\"n\">form</span> <span class=\"o\">=</span> <span class=\"n\">NumberListForm</span><span class=\"p\">({</span><span class=\"s2\">&quot;numbers&quot;</span><span class=\"p\">:</span> <span class=\"s2\">&quot;1,2,a&quot;</span><span class=\"p\">})</span>\n<span class=\"gp\">&gt;&gt;&gt; </span><span class=\"n\">form</span><span class=\"o\">.</span><span class=\"n\">is_valid</span><span class=\"p\">()</span>\n<span class=\"go\">False</span>\n</code></pre></div>\n</dd></dl>\n\n<dl class=\"py attribute\">\n<dt class=\"sig sig-object py\" id=\"django.contrib.postgres.forms.SimpleArrayField.delimiter\">\n<span class=\"sig-name descname\"><span class=\"pre\">delimiter</span></span><a class=\"heading-anchor\" href=\"#django.contrib.postgres.forms.SimpleArrayField.delimiter\"><span class=\"visually-hidden\">Link to this definition</span><span aria-hidden=\"true\">#</span></a></dt>\n<dd><p>这是一个可选参数，默认为逗号：<code class=\"docutils literal notranslate\"><span class=\"pre\">,</span></code>。这个值用于分隔提交的数据。它允许你链式使用 <code class=\"docutils literal notranslate\"><span class=\"pre\">SimpleArrayField</span></code> 来处理多维数据：</p>\n<div class=\"code-block\" data-language=\"pycon\"><div class=\"code-block-toolbar\"><span class=\"code-block-language\">Python console</span><button type=\"button\" class=\"copy-button\" data-copy hidden><span class=\"copy-button-label\">Copy</span></button></div><pre role=\"group\" tabindex=\"0\" aria-label=\"Python console code\"><code><span class=\"gp\">&gt;&gt;&gt; </span><span class=\"kn\">from</span><span class=\"w\"> </span><span class=\"nn\">django</span><span class=\"w\"> </span><span class=\"kn\">import</span> <span class=\"n\">forms</span>\n<span class=\"gp\">&gt;&gt;&gt; </span><span class=\"kn\">from</span><span class=\"w\"> </span><span class=\"nn\">django.contrib.postgres.forms</span><span class=\"w\"> </span><span class=\"kn\">import</span> <span class=\"n\">SimpleArrayField</span>\n\n<span class=\"gp\">&gt;&gt;&gt; </span><span class=\"k\">class</span><span class=\"w\"> </span><span class=\"nc\">GridForm</span><span class=\"p\">(</span><span class=\"n\">forms</span><span class=\"o\">.</span><span class=\"n\">Form</span><span class=\"p\">):</span>\n<span class=\"gp\">... </span>    <span class=\"n\">places</span> <span class=\"o\">=</span> <span class=\"n\">SimpleArrayField</span><span class=\"p\">(</span><span class=\"n\">SimpleArrayField</span><span class=\"p\">(</span><span class=\"n\">IntegerField</span><span class=\"p\">()),</span> <span class=\"n\">delimiter</span><span class=\"o\">=</span><span class=\"s2\">&quot;|&quot;</span><span class=\"p\">)</span>\n<span class=\"gp\">...</span>\n\n<span class=\"gp\">&gt;&gt;&gt; </span><span class=\"n\">form</span> <span class=\"o\">=</span> <span class=\"n\">GridForm</span><span class=\"p\">({</span><span class=\"s2\">&quot;places&quot;</span><span class=\"p\">:</span> <span class=\"s2\">&quot;1,2|2,1|4,3&quot;</span><span class=\"p\">})</span>\n<span class=\"gp\">&gt;&gt;&gt; </span><span class=\"n\">form</span><span class=\"o\">.</span><span class=\"n\">is_valid</span><span class=\"p\">()</span>\n<span class=\"go\">True</span>\n<span class=\"gp\">&gt;&gt;&gt; </span><span class=\"n\">form</span><span class=\"o\">.</span><span class=\"n\">cleaned_data</span>\n<span class=\"go\">{&#39;places&#39;: [[1, 2], [2, 1], [4, 3]]}</span>\n</code></pre></div>\n<aside class=\"admonition admonition-note\" role=\"note\">\n<p class=\"admonition-title\">Note</p>\n<p>该字段不支持定界符的转义，所以当定界符是底层字段中的有效字符时，要小心。定界符不需要只用一个字符。</p>\n</aside>\n</dd></dl>\n\n<dl class=\"py attribute\">\n<dt class=\"sig sig-object py\" id=\"django.contrib.postgres.forms.SimpleArrayField.max_length\">\n<span class=\"sig-name descname\"><span class=\"pre\">max_length</span></span><a class=\"heading-anchor\" href=\"#django.contrib.postgres.forms.SimpleArrayField.max_length\"><span class=\"visually-hidden\">Link to this definition</span><span aria-hidden=\"true\">#</span></a></dt>\n<dd><p>这是一个可选的参数，用于验证数组的长度是否超过了规定的长度。</p>\n</dd></dl>\n\n<dl class=\"py attribute\">\n<dt class=\"sig sig-object py\" id=\"django.contrib.postgres.forms.SimpleArrayField.min_length\">\n<span class=\"sig-name descname\"><span class=\"pre\">min_length</span></span><a class=\"heading-anchor\" href=\"#django.contrib.postgres.forms.SimpleArrayField.min_length\"><span class=\"visually-hidden\">Link to this definition</span><span aria-hidden=\"true\">#</span></a></dt>\n<dd><p>这是一个可选的参数，用于验证数组是否至少达到了指定的长度。</p>\n</dd></dl>\n\n<aside class=\"admonition-user-friendly-forms admonition\">\n<p class=\"admonition-title\">用户友好的表单</p>\n<p><code class=\"docutils literal notranslate\"><span class=\"pre\">SimpleArrayField</span></code> 在大多数情况下并不是特别方便用户使用，但是它是一种有用的方式来格式化来自客户端部件的数据以提交给服务器。</p>\n</aside>\n</dd></dl>\n\n</section>\n<section id=\"splitarrayfield\">\n<h3><code class=\"docutils literal notranslate\"><span class=\"pre\">SplitArrayField</span></code><a class=\"heading-anchor\" href=\"#splitarrayfield\"><span class=\"visually-hidden\">Link to this heading</span><span aria-hidden=\"true\">#</span></a></h3>\n<dl class=\"py class\">\n<dt class=\"sig sig-object py\" id=\"django.contrib.postgres.forms.SplitArrayField\">\n<em class=\"property\"><span class=\"k\"><span class=\"pre\">class</span></span><span class=\"w\"> </span></em><span class=\"sig-name descname\"><span class=\"pre\">SplitArrayField</span></span><span class=\"sig-paren\">(</span><em class=\"sig-param\"><span class=\"n\"><span class=\"pre\">base_field</span></span></em>, <em class=\"sig-param\"><span class=\"n\"><span class=\"pre\">size</span></span></em>, <em class=\"sig-param\"><span class=\"n\"><span class=\"pre\">remove_trailing_nulls</span></span><span class=\"o\"><span class=\"pre\">=</span></span><span class=\"default_value\"><span class=\"pre\">False</span></span></em><span class=\"sig-paren\">)</span><a class=\"heading-anchor\" href=\"#django.contrib.postgres.forms.SplitArrayField\"><span class=\"visually-hidden\">Link to this definition</span><span aria-hidden=\"true\">#</span></a></dt>\n<dd><p>这个字段通过重现底层字段固定的次数来处理数组。</p>\n<dl class=\"py attribute\">\n<dt class=\"sig sig-object py\" id=\"django.contrib.postgres.forms.SplitArrayField.base_field\">\n<span class=\"sig-name descname\"><span class=\"pre\">base_field</span></span><a class=\"heading-anchor\" href=\"#django.contrib.postgres.forms.SplitArrayField.base_field\"><span class=\"visually-hidden\">Link to this definition</span><span aria-hidden=\"true\">#</span></a></dt>\n<dd><p>这是一个必要的参数。它指定了要重复的表单字段。</p>\n</dd></dl>\n\n<dl class=\"py attribute\">\n<dt class=\"sig sig-object py\" id=\"django.contrib.postgres.forms.SplitArrayField.size\">\n<span class=\"sig-name descname\"><span class=\"pre\">size</span></span><a class=\"heading-anchor\" href=\"#django.contrib.postgres.forms.SplitArrayField.size\"><span class=\"visually-hidden\">Link to this definition</span><span aria-hidden=\"true\">#</span></a></dt>\n<dd><p>这是基础字段的固定使用次数。</p>\n</dd></dl>\n\n<dl class=\"py attribute\">\n<dt class=\"sig sig-object py\" id=\"django.contrib.postgres.forms.SplitArrayField.remove_trailing_nulls\">\n<span class=\"sig-name descname\"><span class=\"pre\">remove_trailing_nulls</span></span><a class=\"heading-anchor\" href=\"#django.contrib.postgres.forms.SplitArrayField.remove_trailing_nulls\"><span class=\"visually-hidden\">Link to this definition</span><span aria-hidden=\"true\">#</span></a></dt>\n<dd><p>默认情况下，这被设置为 <code class=\"docutils literal notranslate\"><span class=\"pre\">False</span></code>。当 <code class=\"docutils literal notranslate\"><span class=\"pre\">False</span></code> 时，重复字段的每个值都会被存储。当设置为 <code class=\"docutils literal notranslate\"><span class=\"pre\">True</span></code> 时，任何尾部为空白的值将从结果中删除。如果底层字段有 <code class=\"docutils literal notranslate\"><span class=\"pre\">required=True</span></code>，但 <code class=\"docutils literal notranslate\"><span class=\"pre\">remove_trailing_nulls</span></code> 是 <code class=\"docutils literal notranslate\"><span class=\"pre\">True</span></code>，那么只有在最后才允许有空值，并且空值会被消除。</p>\n<p>一些例子：</p>\n<div class=\"code-block\" data-language=\"default\"><div class=\"code-block-toolbar\"><span class=\"code-block-language\">Code</span><button type=\"button\" class=\"copy-button\" data-copy hidden><span class=\"copy-button-label\">Copy</span></button></div><pre role=\"group\" tabindex=\"0\" aria-label=\"Code code\"><code><span class=\"n\">SplitArrayField</span><span class=\"p\">(</span><span class=\"n\">IntegerField</span><span class=\"p\">(</span><span class=\"n\">required</span><span class=\"o\">=</span><span class=\"kc\">True</span><span class=\"p\">),</span> <span class=\"n\">size</span><span class=\"o\">=</span><span class=\"mi\">3</span><span class=\"p\">,</span> <span class=\"n\">remove_trailing_nulls</span><span class=\"o\">=</span><span class=\"kc\">False</span><span class=\"p\">)</span>\n\n<span class=\"p\">[</span><span class=\"s2\">&quot;1&quot;</span><span class=\"p\">,</span> <span class=\"s2\">&quot;2&quot;</span><span class=\"p\">,</span> <span class=\"s2\">&quot;3&quot;</span><span class=\"p\">]</span>  <span class=\"c1\"># -&gt; [1, 2, 3]</span>\n<span class=\"p\">[</span><span class=\"s2\">&quot;1&quot;</span><span class=\"p\">,</span> <span class=\"s2\">&quot;2&quot;</span><span class=\"p\">,</span> <span class=\"s2\">&quot;&quot;</span><span class=\"p\">]</span>  <span class=\"c1\"># -&gt; ValidationError - third entry required.</span>\n<span class=\"p\">[</span><span class=\"s2\">&quot;1&quot;</span><span class=\"p\">,</span> <span class=\"s2\">&quot;&quot;</span><span class=\"p\">,</span> <span class=\"s2\">&quot;3&quot;</span><span class=\"p\">]</span>  <span class=\"c1\"># -&gt; ValidationError - second entry required.</span>\n<span class=\"p\">[</span><span class=\"s2\">&quot;&quot;</span><span class=\"p\">,</span> <span class=\"s2\">&quot;2&quot;</span><span class=\"p\">,</span> <span class=\"s2\">&quot;&quot;</span><span class=\"p\">]</span>  <span class=\"c1\"># -&gt; ValidationError - first and third entries required.</span>\n\n<span class=\"n\">SplitArrayField</span><span class=\"p\">(</span><span class=\"n\">IntegerField</span><span class=\"p\">(</span><span class=\"n\">required</span><span class=\"o\">=</span><span class=\"kc\">False</span><span class=\"p\">),</span> <span class=\"n\">size</span><span class=\"o\">=</span><span class=\"mi\">3</span><span class=\"p\">,</span> <span class=\"n\">remove_trailing_nulls</span><span class=\"o\">=</span><span class=\"kc\">False</span><span class=\"p\">)</span>\n\n<span class=\"p\">[</span><span class=\"s2\">&quot;1&quot;</span><span class=\"p\">,</span> <span class=\"s2\">&quot;2&quot;</span><span class=\"p\">,</span> <span class=\"s2\">&quot;3&quot;</span><span class=\"p\">]</span>  <span class=\"c1\"># -&gt; [1, 2, 3]</span>\n<span class=\"p\">[</span><span class=\"s2\">&quot;1&quot;</span><span class=\"p\">,</span> <span class=\"s2\">&quot;2&quot;</span><span class=\"p\">,</span> <span class=\"s2\">&quot;&quot;</span><span class=\"p\">]</span>  <span class=\"c1\"># -&gt; [1, 2, None]</span>\n<span class=\"p\">[</span><span class=\"s2\">&quot;1&quot;</span><span class=\"p\">,</span> <span class=\"s2\">&quot;&quot;</span><span class=\"p\">,</span> <span class=\"s2\">&quot;3&quot;</span><span class=\"p\">]</span>  <span class=\"c1\"># -&gt; [1, None, 3]</span>\n<span class=\"p\">[</span><span class=\"s2\">&quot;&quot;</span><span class=\"p\">,</span> <span class=\"s2\">&quot;2&quot;</span><span class=\"p\">,</span> <span class=\"s2\">&quot;&quot;</span><span class=\"p\">]</span>  <span class=\"c1\"># -&gt; [None, 2, None]</span>\n\n<span class=\"n\">SplitArrayField</span><span class=\"p\">(</span><span class=\"n\">IntegerField</span><span class=\"p\">(</span><span class=\"n\">required</span><span class=\"o\">=</span><span class=\"kc\">True</span><span class=\"p\">),</span> <span class=\"n\">size</span><span class=\"o\">=</span><span class=\"mi\">3</span><span class=\"p\">,</span> <span class=\"n\">remove_trailing_nulls</span><span class=\"o\">=</span><span class=\"kc\">True</span><span class=\"p\">)</span>\n\n<span class=\"p\">[</span><span class=\"s2\">&quot;1&quot;</span><span class=\"p\">,</span> <span class=\"s2\">&quot;2&quot;</span><span class=\"p\">,</span> <span class=\"s2\">&quot;3&quot;</span><span class=\"p\">]</span>  <span class=\"c1\"># -&gt; [1, 2, 3]</span>\n<span class=\"p\">[</span><span class=\"s2\">&quot;1&quot;</span><span class=\"p\">,</span> <span class=\"s2\">&quot;2&quot;</span><span class=\"p\">,</span> <span class=\"s2\">&quot;&quot;</span><span class=\"p\">]</span>  <span class=\"c1\"># -&gt; [1, 2]</span>\n<span class=\"p\">[</span><span class=\"s2\">&quot;1&quot;</span><span class=\"p\">,</span> <span class=\"s2\">&quot;&quot;</span><span class=\"p\">,</span> <span class=\"s2\">&quot;3&quot;</span><span class=\"p\">]</span>  <span class=\"c1\"># -&gt; ValidationError - second entry required.</span>\n<span class=\"p\">[</span><span class=\"s2\">&quot;&quot;</span><span class=\"p\">,</span> <span class=\"s2\">&quot;2&quot;</span><span class=\"p\">,</span> <span class=\"s2\">&quot;&quot;</span><span class=\"p\">]</span>  <span class=\"c1\"># -&gt; ValidationError - first entry required.</span>\n\n<span class=\"n\">SplitArrayField</span><span class=\"p\">(</span><span class=\"n\">IntegerField</span><span class=\"p\">(</span><span class=\"n\">required</span><span class=\"o\">=</span><span class=\"kc\">False</span><span class=\"p\">),</span> <span class=\"n\">size</span><span class=\"o\">=</span><span class=\"mi\">3</span><span class=\"p\">,</span> <span class=\"n\">remove_trailing_nulls</span><span class=\"o\">=</span><span class=\"kc\">True</span><span class=\"p\">)</span>\n\n<span class=\"p\">[</span><span class=\"s2\">&quot;1&quot;</span><span class=\"p\">,</span> <span class=\"s2\">&quot;2&quot;</span><span class=\"p\">,</span> <span class=\"s2\">&quot;3&quot;</span><span class=\"p\">]</span>  <span class=\"c1\"># -&gt; [1, 2, 3]</span>\n<span class=\"p\">[</span><span class=\"s2\">&quot;1&quot;</span><span class=\"p\">,</span> <span class=\"s2\">&quot;2&quot;</span><span class=\"p\">,</span> <span class=\"s2\">&quot;&quot;</span><span class=\"p\">]</span>  <span class=\"c1\"># -&gt; [1, 2]</span>\n<span class=\"p\">[</span><span class=\"s2\">&quot;1&quot;</span><span class=\"p\">,</span> <span class=\"s2\">&quot;&quot;</span><span class=\"p\">,</span> <span class=\"s2\">&quot;3&quot;</span><span class=\"p\">]</span>  <span class=\"c1\"># -&gt; [1, None, 3]</span>\n<span class=\"p\">[</span><span class=\"s2\">&quot;&quot;</span><span class=\"p\">,</span> <span class=\"s2\">&quot;2&quot;</span><span class=\"p\">,</span> <span class=\"s2\">&quot;&quot;</span><span class=\"p\">]</span>  <span class=\"c1\"># -&gt; [None, 2]</span>\n</code></pre></div>\n</dd></dl>\n\n</dd></dl>\n\n</section>\n<section id=\"hstorefield\">\n<h3><code class=\"docutils literal notranslate\"><span class=\"pre\">HStoreField</span></code><a class=\"heading-anchor\" href=\"#hstorefield\"><span class=\"visually-hidden\">Link to this heading</span><span aria-hidden=\"true\">#</span></a></h3>\n<dl class=\"py class\">\n<dt class=\"sig sig-object py\" id=\"django.contrib.postgres.forms.HStoreField\">\n<em class=\"property\"><span class=\"k\"><span class=\"pre\">class</span></span><span class=\"w\"> </span></em><span class=\"sig-name descname\"><span class=\"pre\">HStoreField</span></span><a class=\"heading-anchor\" href=\"#django.contrib.postgres.forms.HStoreField\"><span class=\"visually-hidden\">Link to this definition</span><span aria-hidden=\"true\">#</span></a></dt>\n<dd><p>一个为 <a class=\"reference internal\" href=\"/zh-hans/4.2/ref/contrib/postgres/fields/#django.contrib.postgres.fields.HStoreField\" title=\"django.contrib.postgres.fields.HStoreField\"><code class=\"xref py py-class docutils literal notranslate\"><span class=\"pre\">HStoreField</span></code></a> 接受 JSON 编码数据的字段。它将所有的值（除了空值）转换为字符串。它由一个 HTML <code class=\"docutils literal notranslate\"><span class=\"pre\">&lt;textarea&gt;</span></code> 表示。</p>\n<aside class=\"admonition-user-friendly-forms admonition\">\n<p class=\"admonition-title\">用户友好的表单</p>\n<p><code class=\"docutils literal notranslate\"><span class=\"pre\">HStoreField</span></code> 在大多数情况下对用户不是特别友好，但是它是一种有用的方式来格式化来自客户端部件的数据以提交给服务器。</p>\n</aside>\n<aside class=\"admonition admonition-note\" role=\"note\">\n<p class=\"admonition-title\">Note</p>\n<p>在某些情况下，可能需要要求或限制对某个字段有效的键。这可以使用 <a class=\"reference internal\" href=\"/zh-hans/4.2/ref/contrib/postgres/validators/#django.contrib.postgres.validators.KeysValidator\" title=\"django.contrib.postgres.validators.KeysValidator\"><code class=\"xref py py-class docutils literal notranslate\"><span class=\"pre\">KeysValidator</span></code></a> 来完成。</p>\n</aside>\n</dd></dl>\n\n</section>\n<section id=\"range-fields\">\n<h3>范围字段<a class=\"heading-anchor\" href=\"#range-fields\"><span class=\"visually-hidden\">Link to this heading</span><span aria-hidden=\"true\">#</span></a></h3>\n<p>这组字段在接受范围数据方面都有类似的功能。它们基于 <a class=\"reference internal\" href=\"/zh-hans/4.2/ref/forms/fields/#django.forms.MultiValueField\" title=\"django.forms.MultiValueField\"><code class=\"xref py py-class docutils literal notranslate\"><span class=\"pre\">MultiValueField</span></code></a>。它们将一个省略的值视为一个无边界的范围。它们还验证了下限不大于上限。所有这些字段都使用 <a class=\"reference internal\" href=\"#django.contrib.postgres.forms.RangeWidget\" title=\"django.contrib.postgres.forms.RangeWidget\"><code class=\"xref py py-class docutils literal notranslate\"><span class=\"pre\">RangeWidget</span></code></a>。</p>\n<section id=\"integerrangefield\">\n<h4><code class=\"docutils literal notranslate\"><span class=\"pre\">IntegerRangeField</span></code><a class=\"heading-anchor\" href=\"#integerrangefield\"><span class=\"visually-hidden\">Link to this heading</span><span aria-hidden=\"true\">#</span></a></h4>\n<dl class=\"py class\">\n<dt class=\"sig sig-object py\" id=\"django.contrib.postgres.forms.IntegerRangeField\">\n<em class=\"property\"><span class=\"k\"><span class=\"pre\">class</span></span><span class=\"w\"> </span></em><span class=\"sig-name descname\"><span class=\"pre\">IntegerRangeField</span></span><a class=\"heading-anchor\" href=\"#django.contrib.postgres.forms.IntegerRangeField\"><span class=\"visually-hidden\">Link to this definition</span><span aria-hidden=\"true\">#</span></a></dt>\n<dd><p>基于 <a class=\"reference internal\" href=\"/zh-hans/4.2/ref/forms/fields/#django.forms.IntegerField\" title=\"django.forms.IntegerField\"><code class=\"xref py py-class docutils literal notranslate\"><span class=\"pre\">IntegerField</span></code></a> 并将其输入翻译为 <code class=\"docutils literal notranslate\"><span class=\"pre\">django.db.backends.postgresql.psycopg_any.NumericRange</span></code>。对于 <a class=\"reference internal\" href=\"/zh-hans/4.2/ref/contrib/postgres/fields/#django.contrib.postgres.fields.IntegerRangeField\" title=\"django.contrib.postgres.fields.IntegerRangeField\"><code class=\"xref py py-class docutils literal notranslate\"><span class=\"pre\">IntegerRangeField</span></code></a> 和 <a class=\"reference internal\" href=\"/zh-hans/4.2/ref/contrib/postgres/fields/#django.contrib.postgres.fields.BigIntegerRangeField\" title=\"django.contrib.postgres.fields.BigIntegerRangeField\"><code class=\"xref py py-class docutils literal notranslate\"><span class=\"pre\">BigIntegerRangeField</span></code></a> 的默认值。</p>\n</dd></dl>\n\n</section>\n<section id=\"decimalrangefield\">\n<h4><code class=\"docutils literal notranslate\"><span class=\"pre\">DecimalRangeField</span></code><a class=\"heading-anchor\" href=\"#decimalrangefield\"><span class=\"visually-hidden\">Link to this heading</span><span aria-hidden=\"true\">#</span></a></h4>\n<dl class=\"py class\">\n<dt class=\"sig sig-object py\" id=\"django.contrib.postgres.forms.DecimalRangeField\">\n<em class=\"property\"><span class=\"k\"><span class=\"pre\">class</span></span><span class=\"w\"> </span></em><span class=\"sig-name descname\"><span class=\"pre\">DecimalRangeField</span></span><a class=\"heading-anchor\" href=\"#django.contrib.postgres.forms.DecimalRangeField\"><span class=\"visually-hidden\">Link to this definition</span><span aria-hidden=\"true\">#</span></a></dt>\n<dd><p>基于 <a class=\"reference internal\" href=\"/zh-hans/4.2/ref/forms/fields/#django.forms.DecimalField\" title=\"django.forms.DecimalField\"><code class=\"xref py py-class docutils literal notranslate\"><span class=\"pre\">DecimalField</span></code></a> 并将其输入翻译为 <code class=\"docutils literal notranslate\"><span class=\"pre\">django.db.backends.postgresql.psycopg_any.NumericRange</span></code>。对于 <a class=\"reference internal\" href=\"/zh-hans/4.2/ref/contrib/postgres/fields/#django.contrib.postgres.fields.DecimalRangeField\" title=\"django.contrib.postgres.fields.DecimalRangeField\"><code class=\"xref py py-class docutils literal notranslate\"><span class=\"pre\">DecimalRangeField</span></code></a> 的默认值。</p>\n</dd></dl>\n\n</section>\n<section id=\"datetimerangefield\">\n<h4><code class=\"docutils literal notranslate\"><span class=\"pre\">DateTimeRangeField</span></code><a class=\"heading-anchor\" href=\"#datetimerangefield\"><span class=\"visually-hidden\">Link to this heading</span><span aria-hidden=\"true\">#</span></a></h4>\n<dl class=\"py class\">\n<dt class=\"sig sig-object py\" id=\"django.contrib.postgres.forms.DateTimeRangeField\">\n<em class=\"property\"><span class=\"k\"><span class=\"pre\">class</span></span><span class=\"w\"> </span></em><span class=\"sig-name descname\"><span class=\"pre\">DateTimeRangeField</span></span><a class=\"heading-anchor\" href=\"#django.contrib.postgres.forms.DateTimeRangeField\"><span class=\"visually-hidden\">Link to this definition</span><span aria-hidden=\"true\">#</span></a></dt>\n<dd><p>基于 <a class=\"reference internal\" href=\"/zh-hans/4.2/ref/forms/fields/#django.forms.DateTimeField\" title=\"django.forms.DateTimeField\"><code class=\"xref py py-class docutils literal notranslate\"><span class=\"pre\">DateTimeField</span></code></a> 并将其输入翻译为 <code class=\"docutils literal notranslate\"><span class=\"pre\">django.db.backends.postgresql.psycopg_any.DateTimeTZRange</span></code>。对于 <a class=\"reference internal\" href=\"/zh-hans/4.2/ref/contrib/postgres/fields/#django.contrib.postgres.fields.DateTimeRangeField\" title=\"django.contrib.postgres.fields.DateTimeRangeField\"><code class=\"xref py py-class docutils literal notranslate\"><span class=\"pre\">DateTimeRangeField</span></code></a> 的默认值。</p>\n</dd></dl>\n\n</section>\n<section id=\"daterangefield\">\n<h4><code class=\"docutils literal notranslate\"><span class=\"pre\">DateRangeField</span></code><a class=\"heading-anchor\" href=\"#daterangefield\"><span class=\"visually-hidden\">Link to this heading</span><span aria-hidden=\"true\">#</span></a></h4>\n<dl class=\"py class\">\n<dt class=\"sig sig-object py\" id=\"django.contrib.postgres.forms.DateRangeField\">\n<em class=\"property\"><span class=\"k\"><span class=\"pre\">class</span></span><span class=\"w\"> </span></em><span class=\"sig-name descname\"><span class=\"pre\">DateRangeField</span></span><a class=\"heading-anchor\" href=\"#django.contrib.postgres.forms.DateRangeField\"><span class=\"visually-hidden\">Link to this definition</span><span aria-hidden=\"true\">#</span></a></dt>\n<dd><p>基于 <a class=\"reference internal\" href=\"/zh-hans/4.2/ref/forms/fields/#django.forms.DateField\" title=\"django.forms.DateField\"><code class=\"xref py py-class docutils literal notranslate\"><span class=\"pre\">DateField</span></code></a> 并将其输入翻译为 <code class=\"docutils literal notranslate\"><span class=\"pre\">django.db.backends.postgresql.psycopg_any.DateRange</span></code>。对于 <a class=\"reference internal\" href=\"/zh-hans/4.2/ref/contrib/postgres/fields/#django.contrib.postgres.fields.DateRangeField\" title=\"django.contrib.postgres.fields.DateRangeField\"><code class=\"xref py py-class docutils literal notranslate\"><span class=\"pre\">DateRangeField</span></code></a> 的默认值。</p>\n</dd></dl>\n\n</section>\n</section>\n</section>\n<section id=\"widgets\">\n<h2>部件<a class=\"heading-anchor\" href=\"#widgets\"><span class=\"visually-hidden\">Link to this heading</span><span aria-hidden=\"true\">#</span></a></h2>\n<section id=\"rangewidget\">\n<h3><code class=\"docutils literal notranslate\"><span class=\"pre\">RangeWidget</span></code><a class=\"heading-anchor\" href=\"#rangewidget\"><span class=\"visually-hidden\">Link to this heading</span><span aria-hidden=\"true\">#</span></a></h3>\n<dl class=\"py class\">\n<dt class=\"sig sig-object py\" id=\"django.contrib.postgres.forms.RangeWidget\">\n<em class=\"property\"><span class=\"k\"><span class=\"pre\">class</span></span><span class=\"w\"> </span></em><span class=\"sig-name descname\"><span class=\"pre\">RangeWidget</span></span><span class=\"sig-paren\">(</span><em class=\"sig-param\"><span class=\"n\"><span class=\"pre\">base_widget</span></span></em>, <em class=\"sig-param\"><span class=\"n\"><span class=\"pre\">attrs</span></span><span class=\"o\"><span class=\"pre\">=</span></span><span class=\"default_value\"><span class=\"pre\">None</span></span></em><span class=\"sig-paren\">)</span><a class=\"heading-anchor\" href=\"#django.contrib.postgres.forms.RangeWidget\"><span class=\"visually-hidden\">Link to this definition</span><span aria-hidden=\"true\">#</span></a></dt>\n<dd><p>所有范围字段都使用的部件。基于 <a class=\"reference internal\" href=\"/zh-hans/4.2/ref/forms/widgets/#django.forms.MultiWidget\" title=\"django.forms.MultiWidget\"><code class=\"xref py py-class docutils literal notranslate\"><span class=\"pre\">MultiWidget</span></code></a>。</p>\n<p><a class=\"reference internal\" href=\"#django.contrib.postgres.forms.RangeWidget\" title=\"django.contrib.postgres.forms.RangeWidget\"><code class=\"xref py py-class docutils literal notranslate\"><span class=\"pre\">RangeWidget</span></code></a> 有一个必要的参数：</p>\n<dl class=\"py attribute\">\n<dt class=\"sig sig-object py\" id=\"django.contrib.postgres.forms.RangeWidget.base_widget\">\n<span class=\"sig-name descname\"><span class=\"pre\">base_widget</span></span><a class=\"heading-anchor\" href=\"#django.contrib.postgres.forms.RangeWidget.base_widget\"><span class=\"visually-hidden\">Link to this definition</span><span aria-hidden=\"true\">#</span></a></dt>\n<dd><p>一个 <a class=\"reference internal\" href=\"#django.contrib.postgres.forms.RangeWidget\" title=\"django.contrib.postgres.forms.RangeWidget\"><code class=\"xref py py-class docutils literal notranslate\"><span class=\"pre\">RangeWidget</span></code></a> 由 <code class=\"docutils literal notranslate\"><span class=\"pre\">base_widget</span></code> 的二元元组组成。</p>\n</dd></dl>\n\n<dl class=\"py method\">\n<dt class=\"sig sig-object py\" id=\"django.contrib.postgres.forms.RangeWidget.decompress\">\n<span class=\"sig-name descname\"><span class=\"pre\">decompress</span></span><span class=\"sig-paren\">(</span><em class=\"sig-param\"><span class=\"n\"><span class=\"pre\">value</span></span></em><span class=\"sig-paren\">)</span><a class=\"heading-anchor\" href=\"#django.contrib.postgres.forms.RangeWidget.decompress\"><span class=\"visually-hidden\">Link to this definition</span><span aria-hidden=\"true\">#</span></a></dt>\n<dd><p>取一个字段的单个“压缩”值，例如一个 <a class=\"reference internal\" href=\"/zh-hans/4.2/ref/contrib/postgres/fields/#django.contrib.postgres.fields.DateRangeField\" title=\"django.contrib.postgres.fields.DateRangeField\"><code class=\"xref py py-class docutils literal notranslate\"><span class=\"pre\">DateRangeField</span></code></a>，并返回一个元组，代表一个下界和上界。</p>\n</dd></dl>\n\n</dd></dl>\n\n</section>\n</section>","rootId":"postgresql-specific-form-fields-and-widgets","toc":[{"title":"字段","anchor":"fields","children":[{"title":"SimpleArrayField","anchor":"simplearrayfield","children":[]},{"title":"SplitArrayField","anchor":"splitarrayfield","children":[]},{"title":"HStoreField","anchor":"hstorefield","children":[]},{"title":"范围字段","anchor":"range-fields","children":[{"title":"IntegerRangeField","anchor":"integerrangefield","children":[]},{"title":"DecimalRangeField","anchor":"decimalrangefield","children":[]},{"title":"DateTimeRangeField","anchor":"datetimerangefield","children":[]},{"title":"DateRangeField","anchor":"daterangefield","children":[]}]}]},{"title":"部件","anchor":"widgets","children":[{"title":"RangeWidget","anchor":"rangewidget","children":[]}]}],"breadcrumbs":[{"docname":"ref/index","title":"API 参考","url":"/zh-hans/4.2/ref/"},{"docname":"ref/contrib/index","title":"contrib 包","url":"/zh-hans/4.2/ref/contrib/"},{"docname":"ref/contrib/postgres/index","title":"django.contrib.postgres","url":"/zh-hans/4.2/ref/contrib/postgres/"}],"prev":{"docname":"ref/contrib/postgres/fields","title":"PostgreSQL 特有模型字段","url":"/zh-hans/4.2/ref/contrib/postgres/fields/"},"next":{"docname":"ref/contrib/postgres/functions","title":"PostgreSQL 特有数据库函数","url":"/zh-hans/4.2/ref/contrib/postgres/functions/"},"formats":{"html":"/zh-hans/4.2/ref/contrib/postgres/forms/","markdown":"/zh-hans/4.2/ref/contrib/postgres/forms.md","json":"/zh-hans/4.2/ref/contrib/postgres/forms.json"},"source":"https://github.com/django/django/blob/stable/4.2.x/docs/ref/contrib/postgres/forms.txt","official":"https://docs.djangoproject.com/zh-hans/4.2/ref/contrib/postgres/forms/","inVersions":["6.1","6.0","5.2","5.1","5.0","4.2","4.1","4.0","3.2","3.1","3.0","2.2","2.1","2.0"],"inLocales":["en","zh-hans","fr","ja","id","it","pt-br","ko","es","el","pl"]}