---
title: "表单"
version: 6.0
locale: zh-hans
source: https://docs.djangoproject.com/zh-hans/6.0/ref/forms/
canonical: https://djangodocs.dev/zh-hans/6.0/ref/forms/
---
# 表单

详细的表单 API 参考。关于介绍性材料，请参见 [使用表单](/zh-hans/6.0/topics/forms/) 主题指南。

- [表单 API](/zh-hans/6.0/ref/forms/api/)

  - [绑定和非绑定表单](/zh-hans/6.0/ref/forms/api/#bound-and-unbound-forms)
  - [使用表单来验证数据](/zh-hans/6.0/ref/forms/api/#using-forms-to-validate-data)
  - [初始表单值](/zh-hans/6.0/ref/forms/api/#initial-form-values)
  - [检查哪些表格数据已经改变](/zh-hans/6.0/ref/forms/api/#checking-which-form-data-has-changed)
  - [访问表单中的字段](/zh-hans/6.0/ref/forms/api/#accessing-the-fields-from-the-form)
  - [访问“干净的”数据](/zh-hans/6.0/ref/forms/api/#accessing-clean-data)
  - [将表单输出为 HTML](/zh-hans/6.0/ref/forms/api/#outputting-forms-as-html)
  - [更精细的输出](/zh-hans/6.0/ref/forms/api/#more-granular-output)
  - [自定义 `BoundField`](/zh-hans/6.0/ref/forms/api/#customizing-boundfield)
  - [将上传的文件绑定到表单中](/zh-hans/6.0/ref/forms/api/#binding-uploaded-files-to-a-form)
  - [子类化表单](/zh-hans/6.0/ref/forms/api/#subclassing-forms)
  - [表单前缀](/zh-hans/6.0/ref/forms/api/#prefixes-for-forms)
- [表单字段](/zh-hans/6.0/ref/forms/fields/)

  - [核心字段参数](/zh-hans/6.0/ref/forms/fields/#core-field-arguments)
  - [检查字段数据是否有变化](/zh-hans/6.0/ref/forms/fields/#checking-if-the-field-data-has-changed)
  - [内置 `Field` 类](/zh-hans/6.0/ref/forms/fields/#built-in-field-classes)
  - [稍复杂的内置 `Field` 类](/zh-hans/6.0/ref/forms/fields/#slightly-complex-built-in-field-classes)
  - [处理关系的字段](/zh-hans/6.0/ref/forms/fields/#fields-which-handle-relationships)
  - [创建自定义字段](/zh-hans/6.0/ref/forms/fields/#creating-custom-fields)
- [模型表单](/zh-hans/6.0/ref/forms/models/)

  - [Model form `Meta` API](/zh-hans/6.0/ref/forms/models/#model-form-meta-api)
  - [Model form factory functions](/zh-hans/6.0/ref/forms/models/#model-form-factory-functions)
- [表单集函数](/zh-hans/6.0/ref/forms/formsets/)

  - [`formset_factory`](/zh-hans/6.0/ref/forms/formsets/#formset-factory)
- [表单渲染 API](/zh-hans/6.0/ref/forms/renderers/)

  - [低级渲染 API](/zh-hans/6.0/ref/forms/renderers/#the-low-level-render-api)
  - [内置模板表单渲染器](/zh-hans/6.0/ref/forms/renderers/#built-in-template-form-renderers)
  - [表单集模板中可用的上下文](/zh-hans/6.0/ref/forms/renderers/#context-available-in-formset-templates)
  - [表单模板中可用的上下文](/zh-hans/6.0/ref/forms/renderers/#context-available-in-form-templates)
  - [字段模板中可用的上下文](/zh-hans/6.0/ref/forms/renderers/#context-available-in-field-templates)
  - [部件模板中可用的上下文](/zh-hans/6.0/ref/forms/renderers/#context-available-in-widget-templates)
  - [覆盖内置的表单集模板](/zh-hans/6.0/ref/forms/renderers/#overriding-built-in-formset-templates)
  - [覆盖内置表单模板](/zh-hans/6.0/ref/forms/renderers/#overriding-built-in-form-templates)
  - [覆盖内置字段模板](/zh-hans/6.0/ref/forms/renderers/#overriding-built-in-field-templates)
  - [覆盖内置部件模板](/zh-hans/6.0/ref/forms/renderers/#overriding-built-in-widget-templates)
- [部件](/zh-hans/6.0/ref/forms/widgets/)

  - [指定部件](/zh-hans/6.0/ref/forms/widgets/#specifying-widgets)
  - [为部件设置参数](/zh-hans/6.0/ref/forms/widgets/#setting-arguments-for-widgets)
  - [自定义部件实例](/zh-hans/6.0/ref/forms/widgets/#customizing-widget-instances)
  - [基础部件类](/zh-hans/6.0/ref/forms/widgets/#base-widget-classes)
  - [内置部件](/zh-hans/6.0/ref/forms/widgets/#built-in-widgets)
- [表单和字段验证](/zh-hans/6.0/ref/forms/validation/)

  - [引发 `ValidationError`](/zh-hans/6.0/ref/forms/validation/#raising-validationerror)
  - [在实践中使用验证](/zh-hans/6.0/ref/forms/validation/#using-validation-in-practice)