'
```
## "clean" なデータにアクセスする
#### `Form.cleaned_data`
[`Form`](#django.forms.Form) クラスの各フィールドは、データの検証だけでなく、それを「クリーニング」する – すなわち、データを一貫した形式に正規化する役割も担っています。これは素晴らしい機能で、各フィールドにおいて、様々な形式で入力されるデータから、常に整合性のある出力を得ることができます。
たとえば、 [`DateField`](/ja/5.1/ref/forms/fields/#django.forms.DateField) はインプットを Python の `datetime.date` オブジェクトに正規化します。たとえ `'1994-07-15'` という形式の文字列で渡そうが、 `datetime.date` オブジェクトを渡そうが、他の様々な形式で渡そうが、それが検証にパスする限り `DateField` はいつも `datetime.date` オブジェクトに正規化します。
[`Form`](#django.forms.Form) インスタンスを作成し、データをセットして検証した後は、`cleaned_data` 属性を介してクリーンなデータにアクセスできます。
```pycon
>>> data = {
... "subject": "hello",
... "message": "Hi there",
... "sender": "foo@example.com",
... "cc_myself": True,
... }
>>> f = ContactForm(data)
>>> f.is_valid()
True
>>> f.cleaned_data
{'cc_myself': True, 'message': 'Hi there', 'sender': 'foo@example.com', 'subject': 'hello'}
```
`CharField` や `EmailField` といったテキストベースのフィールドは、入力を文字列に正規化します。暗黙的な文字エンコードの動作については、後のドキュメントでカバーします。
もしデータが検証に合格 *しなかった* 場合、 `cleaned_data` の辞書には有効なフィールドのみが含まれます。
```pycon
>>> data = {
... "subject": "",
... "message": "Hi there",
... "sender": "invalid email address",
... "cc_myself": True,
... }
>>> f = ContactForm(data)
>>> f.is_valid()
False
>>> f.cleaned_data
{'cc_myself': True, 'message': 'Hi there'}
```
たとえ `Form` を定義する際に追加のデータを渡しても、 `cleaned_data` には `Form` で定義されたフィールドのキー *のみ* が含まれます。この例では `ContactForm` のコンストラクタに追加のフィールドを渡していますが、 `cleaned_data` にはフォームのフィールドのみが含まれます。
```pycon
>>> data = {
... "subject": "hello",
... "message": "Hi there",
... "sender": "foo@example.com",
... "cc_myself": True,
... "extra_field_1": "foo",
... "extra_field_2": "bar",
... "extra_field_3": "baz",
... }
>>> f = ContactForm(data)
>>> f.is_valid()
True
>>> f.cleaned_data # Doesn't contain extra_field_1, etc.
{'cc_myself': True, 'message': 'Hi there', 'sender': 'foo@example.com', 'subject': 'hello'}
```
`Form` の検証に合格した場合、 任意入力のフィールドのデータが一部含まれていなかったとしても、 *すべての* フィールドのキーと値が含まれています。この例では、渡したデータに `nick_name` フィールドの値は含まれていませんが、 `cleaned_data` には空の値が含まれています。
```pycon
>>> from django import forms
>>> class OptionalPersonForm(forms.Form):
... first_name = forms.CharField()
... last_name = forms.CharField()
... nick_name = forms.CharField(required=False)
...
>>> data = {"first_name": "John", "last_name": "Lennon"}
>>> f = OptionalPersonForm(data)
>>> f.is_valid()
True
>>> f.cleaned_data
{'nick_name': '', 'first_name': 'John', 'last_name': 'Lennon'}
```
上の例では、 `cleaned_data` 中の `nick_name` の値には空の文字列がセットされています。これは、 `nick_name` が `CharField` であり、 `CharField` は空の値を空の文字列として扱うからです。それぞれのフィールドタイプは、それぞれの `空の` 値が何であるか知っています -- たとえば、 `DateField` では空の文字列の代わりに `None` です。それぞれのフィールドの挙動の完全な詳細は、あとの "Built-in `Field` classes" セクションにある "Empty value" ノートを見てください。
特定のいくつかの (フォーム名に基づく) フォームフィールドまたは (さまざまなフィールドの組み合わせを考えて) フォーム全体に対してのバリデーションを行うコードを書くこともできます。これについての詳細は、 [フォームとフィールドのバリデーション](/ja/5.1/ref/forms/validation/) を見てください。
## フォームをHTMLとしてアウトプットする
`Form` オブジェクトの2番目のタスクは、自身をHTMLとしてレンダリングすることです。それを行うには `print` します。
```pycon
>>> f = ContactForm()
>>> print(f)
```
フォームがデータにバインドされている場合、HTMLの出力にはそのデータが適切に含まれます。たとえば、フィールドが `
` で表される場合、データは `value` 属性に含まれます。フィールドが `
` で表される場合、HTMLには必要に応じて `checked` が含まれます。
```pycon
>>> data = {
... "subject": "hello",
... "message": "Hi there",
... "sender": "foo@example.com",
... "cc_myself": True,
... }
>>> f = ContactForm(data)
>>> print(f)
```
このデフォルトの出力は、各フィールドを `
` で囲みます。以下の点に注意してください。
- 柔軟性のために、出力には `
` のタグや `
` のタグは含まれていません。これらは各自で追加するようにしてください。
- それぞれのフィールドタイプはデフォルトの HTML 表現を持っています。 `CharField` は `
` で、 `EmailField` は `
` で表現され、`BooleanField(null=False)` は `
` で表現されます。これらは単なる実用的なデフォルトであり、あるフィールドにどの HTML を使うかは、すぐ後で説明するウィジェットを使って指定できます。
- HTML のそれぞれのタグの `name` は、 `ContactForm` クラスの属性名から直接とられます。
- それぞれのフィールドのテキストラベル、たとえば `'Subject:'`, `'Message:'` , `'Cc myself:'` は、フィールド名のアンダースコアをスペースに変換し、頭文字を大文字に変換して生成されます。これらもまた単なる実用的なデフォルトです; 手動でラベルを指定することもできます。
- それぞれのテキストラベルは HTML `