{"title":"表单","version":"3.2","locale":"zh-hans","docname":"ref/forms/index","url":"/zh-hans/3.2/ref/forms/","canonical":"https://djangodocs.dev/zh-hans/3.2/ref/forms/","summary":"详细的表单 API 参考。关于介绍性材料，请参见 使用表单 主题指南。 表单 API 绑定和非绑定表单 使用表单来验证数据 初始表单值 检查哪些表格数据已经改变 访问表单中的字段 访问“干净的”数据 将表单输出为 HTML 更精细的输出 自定义 BoundField 将上传的文件绑定到表单中 子类化表单 表单前缀 表单字段…","html":"<h1>表单<a class=\"heading-anchor\" href=\"#forms\"><span class=\"visually-hidden\">Link to this heading</span><span aria-hidden=\"true\">#</span></a></h1>\n<p>详细的表单 API 参考。关于介绍性材料，请参见 <a class=\"reference internal\" href=\"/zh-hans/3.2/topics/forms/\"><span class=\"doc\">使用表单</span></a> 主题指南。</p>\n<div class=\"toctree-wrapper compound\">\n<ul>\n<li class=\"toctree-l1\"><a class=\"reference internal\" href=\"/zh-hans/3.2/ref/forms/api/\">表单 API</a><ul>\n<li class=\"toctree-l2\"><a class=\"reference internal\" href=\"/zh-hans/3.2/ref/forms/api/#bound-and-unbound-forms\">绑定和非绑定表单</a></li>\n<li class=\"toctree-l2\"><a class=\"reference internal\" href=\"/zh-hans/3.2/ref/forms/api/#using-forms-to-validate-data\">使用表单来验证数据</a></li>\n<li class=\"toctree-l2\"><a class=\"reference internal\" href=\"/zh-hans/3.2/ref/forms/api/#initial-form-values\">初始表单值</a></li>\n<li class=\"toctree-l2\"><a class=\"reference internal\" href=\"/zh-hans/3.2/ref/forms/api/#checking-which-form-data-has-changed\">检查哪些表格数据已经改变</a></li>\n<li class=\"toctree-l2\"><a class=\"reference internal\" href=\"/zh-hans/3.2/ref/forms/api/#accessing-the-fields-from-the-form\">访问表单中的字段</a></li>\n<li class=\"toctree-l2\"><a class=\"reference internal\" href=\"/zh-hans/3.2/ref/forms/api/#accessing-clean-data\">访问“干净的”数据</a></li>\n<li class=\"toctree-l2\"><a class=\"reference internal\" href=\"/zh-hans/3.2/ref/forms/api/#outputting-forms-as-html\">将表单输出为 HTML</a></li>\n<li class=\"toctree-l2\"><a class=\"reference internal\" href=\"/zh-hans/3.2/ref/forms/api/#more-granular-output\">更精细的输出</a></li>\n<li class=\"toctree-l2\"><a class=\"reference internal\" href=\"/zh-hans/3.2/ref/forms/api/#customizing-boundfield\">自定义 <code class=\"docutils literal notranslate\"><span class=\"pre\">BoundField</span></code></a></li>\n<li class=\"toctree-l2\"><a class=\"reference internal\" href=\"/zh-hans/3.2/ref/forms/api/#binding-uploaded-files-to-a-form\">将上传的文件绑定到表单中</a></li>\n<li class=\"toctree-l2\"><a class=\"reference internal\" href=\"/zh-hans/3.2/ref/forms/api/#subclassing-forms\">子类化表单</a></li>\n<li class=\"toctree-l2\"><a class=\"reference internal\" href=\"/zh-hans/3.2/ref/forms/api/#prefixes-for-forms\">表单前缀</a></li>\n</ul>\n</li>\n<li class=\"toctree-l1\"><a class=\"reference internal\" href=\"/zh-hans/3.2/ref/forms/fields/\">表单字段</a><ul>\n<li class=\"toctree-l2\"><a class=\"reference internal\" href=\"/zh-hans/3.2/ref/forms/fields/#core-field-arguments\">核心字段参数</a></li>\n<li class=\"toctree-l2\"><a class=\"reference internal\" href=\"/zh-hans/3.2/ref/forms/fields/#checking-if-the-field-data-has-changed\">检查字段数据是否有变化</a></li>\n<li class=\"toctree-l2\"><a class=\"reference internal\" href=\"/zh-hans/3.2/ref/forms/fields/#built-in-field-classes\">内置 <code class=\"docutils literal notranslate\"><span class=\"pre\">Field</span></code> 类</a></li>\n<li class=\"toctree-l2\"><a class=\"reference internal\" href=\"/zh-hans/3.2/ref/forms/fields/#slightly-complex-built-in-field-classes\">稍复杂的内置 <code class=\"docutils literal notranslate\"><span class=\"pre\">Field</span></code> 类</a></li>\n<li class=\"toctree-l2\"><a class=\"reference internal\" href=\"/zh-hans/3.2/ref/forms/fields/#fields-which-handle-relationships\">处理关系的字段</a></li>\n<li class=\"toctree-l2\"><a class=\"reference internal\" href=\"/zh-hans/3.2/ref/forms/fields/#creating-custom-fields\">创建自定义字段</a></li>\n</ul>\n</li>\n<li class=\"toctree-l1\"><a class=\"reference internal\" href=\"/zh-hans/3.2/ref/forms/models/\">模型表单函数</a><ul>\n<li class=\"toctree-l2\"><a class=\"reference internal\" href=\"/zh-hans/3.2/ref/forms/models/#modelform-factory\"><code class=\"docutils literal notranslate\"><span class=\"pre\">modelform_factory</span></code></a></li>\n<li class=\"toctree-l2\"><a class=\"reference internal\" href=\"/zh-hans/3.2/ref/forms/models/#modelformset-factory\"><code class=\"docutils literal notranslate\"><span class=\"pre\">modelformset_factory</span></code></a></li>\n<li class=\"toctree-l2\"><a class=\"reference internal\" href=\"/zh-hans/3.2/ref/forms/models/#inlineformset-factory\"><code class=\"docutils literal notranslate\"><span class=\"pre\">inlineformset_factory</span></code></a></li>\n</ul>\n</li>\n<li class=\"toctree-l1\"><a class=\"reference internal\" href=\"/zh-hans/3.2/ref/forms/formsets/\">表单集函数</a><ul>\n<li class=\"toctree-l2\"><a class=\"reference internal\" href=\"/zh-hans/3.2/ref/forms/formsets/#formset-factory\"><code class=\"docutils literal notranslate\"><span class=\"pre\">formset_factory</span></code></a></li>\n</ul>\n</li>\n<li class=\"toctree-l1\"><a class=\"reference internal\" href=\"/zh-hans/3.2/ref/forms/renderers/\">表单渲染 API</a><ul>\n<li class=\"toctree-l2\"><a class=\"reference internal\" href=\"/zh-hans/3.2/ref/forms/renderers/#the-low-level-render-api\">低级渲染 API</a></li>\n<li class=\"toctree-l2\"><a class=\"reference internal\" href=\"/zh-hans/3.2/ref/forms/renderers/#built-in-template-form-renderers\">内置模板表单渲染器</a></li>\n<li class=\"toctree-l2\"><a class=\"reference internal\" href=\"/zh-hans/3.2/ref/forms/renderers/#context-available-in-widget-templates\">部件模板中可用的上下文</a></li>\n<li class=\"toctree-l2\"><a class=\"reference internal\" href=\"/zh-hans/3.2/ref/forms/renderers/#overriding-built-in-widget-templates\">覆盖内置部件模板</a></li>\n</ul>\n</li>\n<li class=\"toctree-l1\"><a class=\"reference internal\" href=\"/zh-hans/3.2/ref/forms/widgets/\">部件</a><ul>\n<li class=\"toctree-l2\"><a class=\"reference internal\" href=\"/zh-hans/3.2/ref/forms/widgets/#specifying-widgets\">指定部件</a></li>\n<li class=\"toctree-l2\"><a class=\"reference internal\" href=\"/zh-hans/3.2/ref/forms/widgets/#setting-arguments-for-widgets\">为部件设置参数</a></li>\n<li class=\"toctree-l2\"><a class=\"reference internal\" href=\"/zh-hans/3.2/ref/forms/widgets/#widgets-inheriting-from-the-select-widget\">继承自 <code class=\"docutils literal notranslate\"><span class=\"pre\">Select</span></code> 部件的部件。</a></li>\n<li class=\"toctree-l2\"><a class=\"reference internal\" href=\"/zh-hans/3.2/ref/forms/widgets/#customizing-widget-instances\">自定义部件实例</a></li>\n<li class=\"toctree-l2\"><a class=\"reference internal\" href=\"/zh-hans/3.2/ref/forms/widgets/#base-widget-classes\">基础部件类</a></li>\n<li class=\"toctree-l2\"><a class=\"reference internal\" href=\"/zh-hans/3.2/ref/forms/widgets/#built-in-widgets\">内置部件</a></li>\n</ul>\n</li>\n<li class=\"toctree-l1\"><a class=\"reference internal\" href=\"/zh-hans/3.2/ref/forms/validation/\">表单和字段验证</a><ul>\n<li class=\"toctree-l2\"><a class=\"reference internal\" href=\"/zh-hans/3.2/ref/forms/validation/#raising-validationerror\">引发 <code class=\"docutils literal notranslate\"><span class=\"pre\">ValidationError</span></code></a></li>\n<li class=\"toctree-l2\"><a class=\"reference internal\" href=\"/zh-hans/3.2/ref/forms/validation/#using-validation-in-practice\">在实践中使用验证</a></li>\n</ul>\n</li>\n</ul>\n</div>","rootId":"forms","toc":[],"breadcrumbs":[{"docname":"ref/index","title":"API 参考","url":"/zh-hans/3.2/ref/"}],"prev":{"docname":"ref/files/uploads","title":"上传的文件和上传处理程序","url":"/zh-hans/3.2/ref/files/uploads/"},"next":{"docname":"ref/forms/api","title":"表单 API","url":"/zh-hans/3.2/ref/forms/api/"},"formats":{"html":"/zh-hans/3.2/ref/forms/","markdown":"/zh-hans/3.2/ref/forms.md","json":"/zh-hans/3.2/ref/forms.json"},"source":"https://github.com/django/django/blob/stable/3.2.x/docs/ref/forms/index.txt","official":"https://docs.djangoproject.com/zh-hans/3.2/ref/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"]}