..
.. META INFORMATION OF TRANSLATION
..
.. $TranslationStatus: Done, waiting for revision $
.. $OriginalRevision: 11298 $
.. $TranslationAuthors: Robson Mendonça $
..
.. INFO OF THIS FILE (DO NOT EDIT! UPDATED BY SUBVERSION)
..
.. $HeadURL$
.. $LastChangedRevision$
.. $LastChangedBy$
.. $LastChangedDate$
..
===========================
Trabalhando com formulários
===========================
.. admonition:: Sobre este documento
Este documento fornece uma introdução as funcionalidades de manipulação de
formulários do Django. Para uma visão mais detalhada da API de forumulários,
veja :doc:`/ref/forms/api`. Para documentação de tipos de campos disponíveis,
veja :doc:`/ref/forms/fields`.
.. highlightlang:: html+django
``django.forms`` é a biblioteca de manipulação de formulários.
Embora seja possível processar submissões de formulário somente usando a classe
:class:`~django.http.HttpRequest` do Django, usando a biblioteca de formulários
fica melhor para a realização de uma série de tarefas comunus relacionadas a
formulários. Usando-o, você pode:
1. Mostrar um formulário HTML com widgets gerados automaticamente.
2. Verificar os dados submetidos conforme um conjuto de regras de validação.
3. Re-exibir um formulário no caso de haver erros de validação.
4. Converter dados de formulários submetidos a tipos relevantes do Python.
Visão geral
===========
A biblioteca trabalha com os seguintes conceitos:
.. glossary::
Widget
Uma classe que corresponde a um widget de formulário HTML, e.g.
```` ou ``