{
  "id": "api/forms/DefaultValueAccessor",
  "title": "DefaultValueAccessor",
  "contents": "\n\n<article>\n  <div class=\"breadcrumb-container\">\n    <div class=\"breadcrumb\">\n      <script type=\"application/ld+json\">\n        {\n          \"@context\": \"http://schema.org\",\n          \"@type\": \"BreadcrumbList\",\n          \"itemListElement\": [\n            { \"@type\": \"ListItem\", \"position\": 1, \"item\": { \"@id\": \"https://angular.io//api\", \"name\": \"API\" } },\n            { \"@type\": \"ListItem\", \"position\": 2, \"item\": { \"@id\": \"https://angular.io/api/forms\", \"name\": \"@angular/forms\" } },\n            { \"@type\": \"ListItem\", \"position\": 3, \"item\": { \"@id\": \"https://angular.io/api/forms/DefaultValueAccessor\", \"name\": \"DefaultValueAccessor\" } }\n          ]\n        }\n      </script>\n        <a href=\"/api\">API</a> > <a href=\"api/forms\">@angular/forms</a>\n    </div>\n    <div class=\"github-links\">\n  <a href=\"https://github.com/angular/angular/edit/master/packages/forms/src/directives/default_value_accessor.ts?message=docs(forms)%3A%20describe%20your%20change...#L36-L160\" aria-label=\"Suggest Edits\" title=\"Suggest Edits\"><i class=\"material-icons\" aria-hidden=\"true\" role=\"img\">mode_edit</i></a>\n  <a href=\"https://github.com/angular/angular/tree/12.0.0-next.7/packages/forms/src/directives/default_value_accessor.ts#L36-L160\" aria-label=\"View Source\" title=\"View Source\"><i class=\"material-icons\" aria-hidden=\"true\" role=\"img\">code</i></a>\n</div>\n  </div>\n  \n  <header class=\"api-header\">\n    <h1 id=\"defaultvalueaccessor\">DefaultValueAccessor<a title=\"Link to this heading\" class=\"header-link\" aria-hidden=\"true\" href=\"api/forms/DefaultValueAccessor#defaultvalueaccessor\"><i class=\"material-icons\">link</i></a></h1>\n    \n    <label class=\"api-type-label directive\">directive</label>\n    \n    \n    \n  </header>\n  \n  <aio-toc class=\"embedded\"></aio-toc>\n\n  <div class=\"api-body\">\n    \n  <section class=\"short-description\">\n    <p>The default <code><a href=\"api/forms/ControlValueAccessor\" class=\"code-anchor\">ControlValueAccessor</a></code> for writing a value and listening to changes on input\nelements. The accessor is used by the <code><a href=\"api/forms/FormControlDirective\" class=\"code-anchor\">FormControlDirective</a></code>, <code><a href=\"api/forms/FormControlName\" class=\"code-anchor\">FormControlName</a></code>, and\n<code><a href=\"api/forms/NgModel\" class=\"code-anchor\">NgModel</a></code> directives.</p>\n\n    <p><a href=\"api/forms/DefaultValueAccessor#description\">See more...</a></p>\n  </section>\n  \n  \n  \n  \n\n  <h2 id=\"ngmodules\">NgModules<a title=\"Link to this heading\" class=\"header-link\" aria-hidden=\"true\" href=\"api/forms/DefaultValueAccessor#ngmodules\"><i class=\"material-icons\">link</i></a></h2>\n<ul class=\"ngmodule-list\">\n\n  <li>\n    <a href=\"api/forms/ReactiveFormsModule\">\n      <code-example language=\"ts\" hidecopy=\"true\" class=\"no-box\">ReactiveFormsModule</code-example>\n    </a>\n  </li>\n  \n  <li>\n    <a href=\"api/forms/FormsModule\">\n      <code-example language=\"ts\" hidecopy=\"true\" class=\"no-box\">FormsModule</code-example>\n    </a>\n  </li>\n  \n</ul>\n\n\n  \n<section class=\"selector-list\">\n  <h2 id=\"selectors\">Selectors<a title=\"Link to this heading\" class=\"header-link\" aria-hidden=\"true\" href=\"api/forms/DefaultValueAccessor#selectors\"><i class=\"material-icons\">link</i></a></h2>\n  \n  <ul>\n    <li><code>input<i>:not([type=checkbox])</i>[<a href=\"api/forms/FormControlName\" class=\"code-anchor\">formControlName</a>]</code></li>\n    \n    <li><code><a href=\"api/forms/DefaultValueAccessor\" class=\"code-anchor\">textarea</a>[<a href=\"api/forms/FormControlName\" class=\"code-anchor\">formControlName</a>]</code></li>\n    \n    <li><code>input<i>:not([type=checkbox])</i>[formControl]</code></li>\n    \n    <li><code><a href=\"api/forms/DefaultValueAccessor\" class=\"code-anchor\">textarea</a>[formControl]</code></li>\n    \n    <li><code>input<i>:not([type=checkbox])</i>[<a href=\"api/forms/NgModel\" class=\"code-anchor\">ngModel</a>]</code></li>\n    \n    <li><code><a href=\"api/forms/DefaultValueAccessor\" class=\"code-anchor\">textarea</a>[<a href=\"api/forms/NgModel\" class=\"code-anchor\">ngModel</a>]</code></li>\n    \n    <li><code>[<a href=\"api/forms/DefaultValueAccessor\" class=\"code-anchor\">ngDefaultControl</a>]</code></li>\n    \n  </ul>\n  \n</section>\n\n\n\n  \n\n\n\n\n\n  \n\n\n  \n  <section class=\"description\">\n    <h2 id=\"description\">Description<a title=\"Link to this heading\" class=\"header-link\" aria-hidden=\"true\" href=\"api/forms/DefaultValueAccessor#description\"><i class=\"material-icons\">link</i></a></h2>\n    \n\n    <h3 id=\"using-the-default-value-accessor\">Using the default value accessor<a title=\"Link to this heading\" class=\"header-link\" aria-hidden=\"true\" href=\"api/forms/DefaultValueAccessor#using-the-default-value-accessor\"><i class=\"material-icons\">link</i></a></h3>\n<p>The following example shows how to use an input element that activates the default value accessor\n(in this case, a text field).</p>\n<code-example language=\"ts\">\nconst firstNameControl = new <a href=\"api/forms/FormControl\" class=\"code-anchor\">FormControl</a>();\n</code-example>\n<code-example>\n&#x3C;input type=\"text\" [formControl]=\"firstNameControl\">\n</code-example>\n<p>This value accessor is used by default for <code>&#x3C;input type=\"text\"></code> and <code>&#x3C;<a href=\"api/forms/DefaultValueAccessor\" class=\"code-anchor\">textarea</a>></code> elements, but\nyou could also use it for custom components that have similar behavior and do not require special\nprocessing. In order to attach the default value accessor to a custom element, add the\n<code><a href=\"api/forms/DefaultValueAccessor\" class=\"code-anchor\">ngDefaultControl</a></code> attribute as shown below.</p>\n<code-example>\n&#x3C;custom-input-component <a href=\"api/forms/DefaultValueAccessor\" class=\"code-anchor\">ngDefaultControl</a> [(<a href=\"api/forms/NgModel\" class=\"code-anchor\">ngModel</a>)]=\"value\">&#x3C;/custom-input-component>\n</code-example>\n\n  </section>\n  \n\n  \n\n  \n\n  \n\n  \n  \n  \n\n  </div>\n</article>\n\n<!-- links to this doc:\n - api/core/Component\n - api/forms\n - api/forms/ControlValueAccessor\n - api/forms/FormsModule\n - api/forms/NG_VALUE_ACCESSOR\n - api/forms/ReactiveFormsModule\n - guide/built-in-directives\n - guide/dependency-injection-in-action\n - guide/router-tutorial-toh\n-->\n<!-- links from this doc:\n - /api\n - api/forms\n - api/forms/ControlValueAccessor\n - api/forms/DefaultValueAccessor#defaultvalueaccessor\n - api/forms/DefaultValueAccessor#description\n - api/forms/DefaultValueAccessor#ngmodules\n - api/forms/DefaultValueAccessor#selectors\n - api/forms/DefaultValueAccessor#using-the-default-value-accessor\n - api/forms/FormControl\n - api/forms/FormControlDirective\n - api/forms/FormControlName\n - api/forms/FormsModule\n - api/forms/NgModel\n - api/forms/ReactiveFormsModule\n - https://github.com/angular/angular/edit/master/packages/forms/src/directives/default_value_accessor.ts?message=docs(forms)%3A%20describe%20your%20change...#L36-L160\n - https://github.com/angular/angular/tree/12.0.0-next.7/packages/forms/src/directives/default_value_accessor.ts#L36-L160\n-->"
}