form.FormController
FormControllerは、入力要素とその入れ物となるフォームの正当(valid)/不当(invalid)または、手つかず(pristine)/手が加えられた(dirty)のような状態の足跡を保持します。 各formのディレクティブは、FormControllerのインスタンスを作成します。
メソッド
| メソッド名 | 説明 |
|---|---|
| $addControl() | フォームに入力要素を登録します。 入力要素はリンクされた際に、ngModelControllerを使用して自動的にこれを行います。 |
| $removeControl() | フォームから入力要素の登録を抹消します。 入力要素は削除された際に、ngModelControllerを使用して自動的にこれを行います。 |
| $setDirty() | フォームを「手が加えられた(dirty)」の状態に設定します。 このメソッドを呼び出すことで、'ng-dirty'クラスを追加し、フォームをdirty状態(ng-dirtyクラス)に設定することが可能です。 このメソッドはまた親のフォームにも反映されます。 |
| $setPristine() | フォームを「手つかず(pristine)」の状態に設定します。 このメソッドを呼び出すことで、'ng-dirty'クラスを削除し、フォームをpristine状態(ng-pristineクラス)に設定することが可能です。 また、このメソッドは、このフォームに含まれるすべての入力要素に反映されます。 保存やリセット後に、再利用する目的でフォームを「手つかず(pristine)」の状態に戻したいケースで便利です。 |
| $setValidity() | フォーム入力要素が正当であると設定します。 また、このメソッドは親のフォームに反映されます。 |
プロパティ
| プロパティ名 | 説明 |
|---|---|
| $pristine | ユーザーがまだフォームに手を加えていなければtrueになります。 |
| $dirty | ユーザーが既にフォームに手を加えていればtrueになります。 |
| $valid | フォームとそれに含まれる全ての入力要素が正当であれば、trueになります。 |
| $invalid | フォームとそれに含まれる全ての入力要素に1つでも不正なものがあれば、trueになります。 |
| $error |
オブジェクトハッシュになっており、全ての不正な入力要素またはフォームへの参照を含みます。 |
© 2017 Google
Licensed under the Creative Commons Attribution License 3.0.
このページは、ページトップのリンク先のAngularJS公式ドキュメント内のページを翻訳した内容を基に構成されています。 下記の項目を確認し、必要に応じて公式のドキュメントをご確認ください。 もし、誤訳などの間違いを見つけましたら、 @tomofまで教えていただければ幸いです。
- AngularJSの更新頻度が高いため、元のコンテンツと比べてドキュメントの情報が古くなっている可能性があります。
- "訳注:"などの断わりを入れた上で、日本人向けの情報やより分かり易くするための追記を行っている事があります。