From 92821e338bda5c13335ce90bd9ccfff01a3a1b81 Mon Sep 17 00:00:00 2001 From: Pete Bacon Darwin Date: Thu, 5 Apr 2018 10:58:12 +0100 Subject: [PATCH] docs(forms): remove unnecessary `{@link Injector}` jsdoc tags (#23186) Inline code blocks are automatically linked, if possible, to their API page. PR Close #23186 --- .../directives/abstract_control_directive.ts | 4 +- .../abstract_form_group_directive.ts | 6 +-- .../forms/src/directives/control_container.ts | 2 +- .../src/directives/control_value_accessor.ts | 4 +- .../src/directives/default_value_accessor.ts | 2 +- .../forms/src/directives/form_interface.ts | 6 +-- packages/forms/src/directives/ng_control.ts | 2 +- packages/forms/src/directives/ng_form.ts | 8 +-- packages/forms/src/directives/ng_model.ts | 14 ++--- .../forms/src/directives/ng_model_group.ts | 4 +- .../src/directives/number_value_accessor.ts | 2 +- .../radio_control_value_accessor.ts | 6 +-- .../src/directives/range_value_accessor.ts | 2 +- .../form_control_directive.ts | 24 ++++----- .../reactive_directives/form_control_name.ts | 28 +++++----- .../form_group_directive.ts | 16 +++--- .../reactive_directives/form_group_name.ts | 40 +++++++------- .../select_control_value_accessor.ts | 8 +-- packages/forms/src/directives/validators.ts | 18 +++---- packages/forms/src/form_builder.ts | 12 ++--- packages/forms/src/forms.ts | 4 +- packages/forms/src/model.ts | 52 +++++++++---------- packages/forms/src/validators.ts | 8 +-- 23 files changed, 136 insertions(+), 136 deletions(-) diff --git a/packages/forms/src/directives/abstract_control_directive.ts b/packages/forms/src/directives/abstract_control_directive.ts index af3da025e0..b63132ba14 100644 --- a/packages/forms/src/directives/abstract_control_directive.ts +++ b/packages/forms/src/directives/abstract_control_directive.ts @@ -19,7 +19,7 @@ import {ValidationErrors} from './validators'; */ export abstract class AbstractControlDirective { /** - * The {@link FormControl}, {@link FormGroup}, or {@link FormArray} + * The `FormControl`, `FormGroup`, or `FormArray` * that backs this directive. Most properties fall through to that * instance. */ @@ -137,7 +137,7 @@ export abstract class AbstractControlDirective { * * it is marked as `untouched` * * value is set to null * - * For more information, see {@link AbstractControl}. + * For more information, see `AbstractControl`. */ reset(value: any = undefined): void { if (this.control) this.control.reset(value); diff --git a/packages/forms/src/directives/abstract_form_group_directive.ts b/packages/forms/src/directives/abstract_form_group_directive.ts index 30829df9f2..df3df50e2b 100644 --- a/packages/forms/src/directives/abstract_form_group_directive.ts +++ b/packages/forms/src/directives/abstract_form_group_directive.ts @@ -18,7 +18,7 @@ import {AsyncValidatorFn, ValidatorFn} from './validators'; /** - * This is a base class for code shared between {@link NgModelGroup} and {@link FormGroupName}. + * This is a base class for code shared between `NgModelGroup` and `FormGroupName`. * * @stable */ @@ -44,7 +44,7 @@ export class AbstractFormGroupDirective extends ControlContainer implements OnIn } /** - * Get the {@link FormGroup} backing this binding. + * Get the `FormGroup` backing this binding. */ get control(): FormGroup { return this.formDirective !.getFormGroup(this); } @@ -54,7 +54,7 @@ export class AbstractFormGroupDirective extends ControlContainer implements OnIn get path(): string[] { return controlPath(this.name, this._parent); } /** - * Get the {@link Form} to which this group belongs. + * Get the `Form` to which this group belongs. */ get formDirective(): Form|null { return this._parent ? this._parent.formDirective : null; } diff --git a/packages/forms/src/directives/control_container.ts b/packages/forms/src/directives/control_container.ts index 39225c0dca..305d6aeeac 100644 --- a/packages/forms/src/directives/control_container.ts +++ b/packages/forms/src/directives/control_container.ts @@ -11,7 +11,7 @@ import {Form} from './form_interface'; /** - * A directive that contains multiple {@link NgControl}s. + * A directive that contains multiple `NgControl`s. * * Only used by the forms module. * diff --git a/packages/forms/src/directives/control_value_accessor.ts b/packages/forms/src/directives/control_value_accessor.ts index ace1f1b2f2..6c65d9ff04 100644 --- a/packages/forms/src/directives/control_value_accessor.ts +++ b/packages/forms/src/directives/control_value_accessor.ts @@ -110,9 +110,9 @@ export interface ControlValueAccessor { } /** - * Used to provide a {@link ControlValueAccessor} for form controls. + * Used to provide a `ControlValueAccessor` for form controls. * - * See {@link DefaultValueAccessor} for how to implement one. + * See `DefaultValueAccessor` for how to implement one. * @stable */ export const NG_VALUE_ACCESSOR = new InjectionToken('NgValueAccessor'); diff --git a/packages/forms/src/directives/default_value_accessor.ts b/packages/forms/src/directives/default_value_accessor.ts index 3120f372c6..2758a879fa 100644 --- a/packages/forms/src/directives/default_value_accessor.ts +++ b/packages/forms/src/directives/default_value_accessor.ts @@ -33,7 +33,7 @@ export const COMPOSITION_BUFFER_MODE = new InjectionToken('CompositionE /** * The default accessor for writing a value and listening to changes that is used by the - * {@link NgModel}, {@link FormControlDirective}, and {@link FormControlName} directives. + * `NgModel`, `FormControlDirective`, and `FormControlName` directives. * * ### Example * ``` diff --git a/packages/forms/src/directives/form_interface.ts b/packages/forms/src/directives/form_interface.ts index c425bfb951..ca7e96d666 100644 --- a/packages/forms/src/directives/form_interface.ts +++ b/packages/forms/src/directives/form_interface.ts @@ -14,7 +14,7 @@ import {NgControl} from './ng_control'; /** - * An interface that {@link FormGroupDirective} and {@link NgForm} implement. + * An interface that `FormGroupDirective` and `NgForm` implement. * * Only used by the forms module. * @@ -32,7 +32,7 @@ export interface Form { removeControl(dir: NgControl): void; /** - * Look up the {@link FormControl} associated with a particular {@link NgControl}. + * Look up the `FormControl` associated with a particular `NgControl`. */ getControl(dir: NgControl): FormControl; @@ -47,7 +47,7 @@ export interface Form { removeFormGroup(dir: AbstractFormGroupDirective): void; /** - * Look up the {@link FormGroup} associated with a particular {@link AbstractFormGroupDirective}. + * Look up the `FormGroup` associated with a particular `AbstractFormGroupDirective`. */ getFormGroup(dir: AbstractFormGroupDirective): FormGroup; diff --git a/packages/forms/src/directives/ng_control.ts b/packages/forms/src/directives/ng_control.ts index 503adf9281..00f4b59aeb 100644 --- a/packages/forms/src/directives/ng_control.ts +++ b/packages/forms/src/directives/ng_control.ts @@ -18,7 +18,7 @@ function unimplemented(): any { /** * A base class that all control directive extend. - * It binds a {@link FormControl} object to a DOM element. + * It binds a `FormControl` object to a DOM element. * * Used internally by Angular forms. * diff --git a/packages/forms/src/directives/ng_form.ts b/packages/forms/src/directives/ng_form.ts index 5ab061eb0c..b9256ba1d9 100644 --- a/packages/forms/src/directives/ng_form.ts +++ b/packages/forms/src/directives/ng_form.ts @@ -28,7 +28,7 @@ const resolvedPromise = Promise.resolve(null); /** * @description * - * Creates a top-level {@link FormGroup} instance and binds it to a form + * Creates a top-level `FormGroup` instance and binds it to a form * to track aggregate form value and validation status. * * As soon as you import the `FormsModule`, this directive becomes active by default on @@ -36,12 +36,12 @@ const resolvedPromise = Promise.resolve(null); * * You can export the directive into a local template variable using `ngForm` as the key * (ex: `#myForm="ngForm"`). This is optional, but useful. Many properties from the underlying - * {@link FormGroup} instance are duplicated on the directive itself, so a reference to it + * `FormGroup` instance are duplicated on the directive itself, so a reference to it * will give you access to the aggregate value and validity status of the form, as well as * user interaction properties like `dirty` and `touched`. * - * To register child controls with the form, you'll want to use {@link NgModel} with a - * `name` attribute. You can also use {@link NgModelGroup} if you'd like to create + * To register child controls with the form, you'll want to use `NgModel` with a + * `name` attribute. You can also use `NgModelGroup` if you'd like to create * sub-groups within the form. * * You can listen to the directive's `ngSubmit` event to be notified when the user has diff --git a/packages/forms/src/directives/ng_model.ts b/packages/forms/src/directives/ng_model.ts index f4164f2360..16c17f0ba1 100644 --- a/packages/forms/src/directives/ng_model.ts +++ b/packages/forms/src/directives/ng_model.ts @@ -48,10 +48,10 @@ const resolvedPromise = Promise.resolve(null); /** * @description * - * Creates a {@link FormControl} instance from a domain model and binds it + * Creates a `FormControl` instance from a domain model and binds it * to a form control element. * - * The {@link FormControl} instance will track the value, user interaction, and + * The `FormControl` instance will track the value, user interaction, and * validation status of the control and keep the view synced with the model. If used * within a parent form, the directive will also register itself with the form as a child * control. @@ -59,18 +59,18 @@ const resolvedPromise = Promise.resolve(null); * This directive can be used by itself or as part of a larger form. All you need is the * `ngModel` selector to activate it. * - * It accepts a domain model as an optional {@link Input}. If you have a one-way binding + * It accepts a domain model as an optional `Input`. If you have a one-way binding * to `ngModel` with `[]` syntax, changing the value of the domain model in the component * class will set the value in the view. If you have a two-way binding with `[()]` syntax * (also known as 'banana-box syntax'), the value in the UI will always be synced back to * the domain model in your class as well. * - * If you wish to inspect the properties of the associated {@link FormControl} (like + * If you wish to inspect the properties of the associated `FormControl` (like * validity state), you can also export the directive into a local template variable using * `ngModel` as the key (ex: `#myVar="ngModel"`). You can then access the control using the * directive's `control` property, but most properties you'll need (like `valid` and `dirty`) * will fall through to the control anyway, so you can access them directly. You can see a - * full list of properties directly available in {@link AbstractControlDirective}. + * full list of properties directly available in `AbstractControlDirective`. * * The following is an example of a simple standalone control using `ngModel`: * @@ -94,8 +94,8 @@ const resolvedPromise = Promise.resolve(null); * * To see `ngModel` examples with different form control types, see: * - * * Radio buttons: {@link RadioControlValueAccessor} - * * Selects: {@link SelectControlValueAccessor} + * * Radio buttons: `RadioControlValueAccessor` + * * Selects: `SelectControlValueAccessor` * * **npm package**: `@angular/forms` * diff --git a/packages/forms/src/directives/ng_model_group.ts b/packages/forms/src/directives/ng_model_group.ts index 4da5587e39..5f72c3545b 100644 --- a/packages/forms/src/directives/ng_model_group.ts +++ b/packages/forms/src/directives/ng_model_group.ts @@ -23,9 +23,9 @@ export const modelGroupProvider: any = { /** * @description * - * Creates and binds a {@link FormGroup} instance to a DOM element. + * Creates and binds a `FormGroup` instance to a DOM element. * - * This directive can only be used as a child of {@link NgForm} (or in other words, + * This directive can only be used as a child of `NgForm` (or in other words, * within `
` tags). * * Use this directive if you'd like to create a sub-group within a form. This can diff --git a/packages/forms/src/directives/number_value_accessor.ts b/packages/forms/src/directives/number_value_accessor.ts index 6eb72aeafb..96a823f72f 100644 --- a/packages/forms/src/directives/number_value_accessor.ts +++ b/packages/forms/src/directives/number_value_accessor.ts @@ -18,7 +18,7 @@ export const NUMBER_VALUE_ACCESSOR: any = { /** * The accessor for writing a number value and listening to changes that is used by the - * {@link NgModel}, {@link FormControlDirective}, and {@link FormControlName} directives. + * `NgModel`, `FormControlDirective`, and `FormControlName` directives. * * ### Example * ``` diff --git a/packages/forms/src/directives/radio_control_value_accessor.ts b/packages/forms/src/directives/radio_control_value_accessor.ts index 7637100ea6..93c61105ea 100644 --- a/packages/forms/src/directives/radio_control_value_accessor.ts +++ b/packages/forms/src/directives/radio_control_value_accessor.ts @@ -59,10 +59,10 @@ export class RadioControlRegistry { * * Writes radio control values and listens to radio control changes. * - * Used by {@link NgModel}, {@link FormControlDirective}, and {@link FormControlName} - * to keep the view synced with the {@link FormControl} model. + * Used by `NgModel`, `FormControlDirective`, and `FormControlName` + * to keep the view synced with the `FormControl` model. * - * If you have imported the {@link FormsModule} or the {@link ReactiveFormsModule}, this + * If you have imported the `FormsModule` or the `ReactiveFormsModule`, this * value accessor will be active on any radio control that has a form directive. You do * **not** need to add a special selector to activate it. * diff --git a/packages/forms/src/directives/range_value_accessor.ts b/packages/forms/src/directives/range_value_accessor.ts index e695fde116..0be4c6ed0d 100644 --- a/packages/forms/src/directives/range_value_accessor.ts +++ b/packages/forms/src/directives/range_value_accessor.ts @@ -18,7 +18,7 @@ export const RANGE_VALUE_ACCESSOR: StaticProvider = { /** * The accessor for writing a range value and listening to changes that is used by the - * {@link NgModel}, {@link FormControlDirective}, and {@link FormControlName} directives. + * `NgModel`, `FormControlDirective`, and `FormControlName` directives. * * ### Example * ``` diff --git a/packages/forms/src/directives/reactive_directives/form_control_directive.ts b/packages/forms/src/directives/reactive_directives/form_control_directive.ts index 1da0c3e9ce..5bc86796a3 100644 --- a/packages/forms/src/directives/reactive_directives/form_control_directive.ts +++ b/packages/forms/src/directives/reactive_directives/form_control_directive.ts @@ -31,27 +31,27 @@ export const formControlBinding: any = { /** * @description * - * Syncs a standalone {@link FormControl} instance to a form control element. + * Syncs a standalone `FormControl` instance to a form control element. * - * This directive ensures that any values written to the {@link FormControl} + * This directive ensures that any values written to the `FormControl` * instance programmatically will be written to the DOM element (model -> view). Conversely, * any values written to the DOM element through user input will be reflected in the - * {@link FormControl} instance (view -> model). + * `FormControl` instance (view -> model). * - * Use this directive if you'd like to create and manage a {@link FormControl} instance directly. - * Simply create a {@link FormControl}, save it to your component class, and pass it into the - * {@link FormControlDirective}. + * Use this directive if you'd like to create and manage a `FormControl` instance directly. + * Simply create a `FormControl`, save it to your component class, and pass it into the + * `FormControlDirective`. * - * This directive is designed to be used as a standalone control. Unlike {@link FormControlName}, - * it does not require that your {@link FormControl} instance be part of any parent - * {@link FormGroup}, and it won't be registered to any {@link FormGroupDirective} that + * This directive is designed to be used as a standalone control. Unlike `FormControlName`, + * it does not require that your `FormControl` instance be part of any parent + * `FormGroup`, and it won't be registered to any `FormGroupDirective` that * exists above it. * * **Get the value**: the `value` property is always synced and available on the - * {@link FormControl} instance. See a full list of available properties in - * {@link AbstractControl}. + * `FormControl` instance. See a full list of available properties in + * `AbstractControl`. * - * **Set the value**: You can pass in an initial value when instantiating the {@link FormControl}, + * **Set the value**: You can pass in an initial value when instantiating the `FormControl`, * or you can set it programmatically later using {@link AbstractControl#setValue setValue} or * {@link AbstractControl#patchValue patchValue}. * diff --git a/packages/forms/src/directives/reactive_directives/form_control_name.ts b/packages/forms/src/directives/reactive_directives/form_control_name.ts index 05d0328eae..462c340d0e 100644 --- a/packages/forms/src/directives/reactive_directives/form_control_name.ts +++ b/packages/forms/src/directives/reactive_directives/form_control_name.ts @@ -30,30 +30,30 @@ export const controlNameBinding: any = { /** * @description * - * Syncs a {@link FormControl} in an existing {@link FormGroup} to a form control + * Syncs a `FormControl` in an existing `FormGroup` to a form control * element by name. * - * This directive ensures that any values written to the {@link FormControl} + * This directive ensures that any values written to the `FormControl` * instance programmatically will be written to the DOM element (model -> view). Conversely, * any values written to the DOM element through user input will be reflected in the - * {@link FormControl} instance (view -> model). + * `FormControl` instance (view -> model). * - * This directive is designed to be used with a parent {@link FormGroupDirective} (selector: + * This directive is designed to be used with a parent `FormGroupDirective` (selector: * `[formGroup]`). * - * It accepts the string name of the {@link FormControl} instance you want to - * link, and will look for a {@link FormControl} registered with that name in the - * closest {@link FormGroup} or {@link FormArray} above it. + * It accepts the string name of the `FormControl` instance you want to + * link, and will look for a `FormControl` registered with that name in the + * closest `FormGroup` or `FormArray` above it. * - * **Access the control**: You can access the {@link FormControl} associated with + * **Access the control**: You can access the `FormControl` associated with * this directive by using the {@link AbstractControl#get get} method. * Ex: `this.form.get('first');` * - * **Get value**: the `value` property is always synced and available on the {@link FormControl}. - * See a full list of available properties in {@link AbstractControl}. + * **Get value**: the `value` property is always synced and available on the `FormControl`. + * See a full list of available properties in `AbstractControl`. * * **Set value**: You can set an initial value for the control when instantiating the - * {@link FormControl}, or you can set it programmatically later using + * `FormControl`, or you can set it programmatically later using * {@link AbstractControl#setValue setValue} or {@link AbstractControl#patchValue patchValue}. * * **Listen to value**: If you want to listen to changes in the value of the control, you can @@ -69,12 +69,12 @@ export const controlNameBinding: any = { * * To see `formControlName` examples with different form control types, see: * - * * Radio buttons: {@link RadioControlValueAccessor} - * * Selects: {@link SelectControlValueAccessor} + * * Radio buttons: `RadioControlValueAccessor` + * * Selects: `SelectControlValueAccessor` * * **npm package**: `@angular/forms` * - * **NgModule**: {@link ReactiveFormsModule} + * **NgModule**: `ReactiveFormsModule` * * ### Use with ngModel * diff --git a/packages/forms/src/directives/reactive_directives/form_group_directive.ts b/packages/forms/src/directives/reactive_directives/form_group_directive.ts index eb5be54f25..6e8d724ad2 100644 --- a/packages/forms/src/directives/reactive_directives/form_group_directive.ts +++ b/packages/forms/src/directives/reactive_directives/form_group_directive.ts @@ -25,20 +25,20 @@ export const formDirectiveProvider: any = { /** * @description * - * Binds an existing {@link FormGroup} to a DOM element. + * Binds an existing `FormGroup` to a DOM element. * - * This directive accepts an existing {@link FormGroup} instance. It will then use this - * {@link FormGroup} instance to match any child {@link FormControl}, {@link FormGroup}, - * and {@link FormArray} instances to child {@link FormControlName}, {@link FormGroupName}, - * and {@link FormArrayName} directives. + * This directive accepts an existing `FormGroup` instance. It will then use this + * `FormGroup` instance to match any child `FormControl`, `FormGroup`, + * and `FormArray` instances to child `FormControlName`, `FormGroupName`, + * and `FormArrayName` directives. * * **Set value**: You can set the form's initial value when instantiating the - * {@link FormGroup}, or you can set it programmatically later using the {@link FormGroup}'s + * `FormGroup`, or you can set it programmatically later using the `FormGroup`'s * {@link AbstractControl#setValue setValue} or {@link AbstractControl#patchValue patchValue} * methods. * * **Listen to value**: If you want to listen to changes in the value of the form, you can subscribe - * to the {@link FormGroup}'s {@link AbstractControl#valueChanges valueChanges} event. You can also + * to the `FormGroup`'s {@link AbstractControl#valueChanges valueChanges} event. You can also * listen to its {@link AbstractControl#statusChanges statusChanges} event to be notified when the * validation status is re-calculated. * @@ -54,7 +54,7 @@ export const formDirectiveProvider: any = { * * **npm package**: `@angular/forms` * - * **NgModule**: {@link ReactiveFormsModule} + * **NgModule**: `ReactiveFormsModule` * * @stable */ diff --git a/packages/forms/src/directives/reactive_directives/form_group_name.ts b/packages/forms/src/directives/reactive_directives/form_group_name.ts index e3c1242a45..ab0ae2f400 100644 --- a/packages/forms/src/directives/reactive_directives/form_group_name.ts +++ b/packages/forms/src/directives/reactive_directives/form_group_name.ts @@ -26,30 +26,30 @@ export const formGroupNameProvider: any = { /** * @description * - * Syncs a nested {@link FormGroup} to a DOM element. + * Syncs a nested `FormGroup` to a DOM element. * - * This directive can only be used with a parent {@link FormGroupDirective} (selector: + * This directive can only be used with a parent `FormGroupDirective` (selector: * `[formGroup]`). * - * It accepts the string name of the nested {@link FormGroup} you want to link, and - * will look for a {@link FormGroup} registered with that name in the parent - * {@link FormGroup} instance you passed into {@link FormGroupDirective}. + * It accepts the string name of the nested `FormGroup` you want to link, and + * will look for a `FormGroup` registered with that name in the parent + * `FormGroup` instance you passed into `FormGroupDirective`. * * Nested form groups can come in handy when you want to validate a sub-group of a * form separately from the rest or when you'd like to group the values of certain * controls into their own nested object. * - * **Access the group**: You can access the associated {@link FormGroup} using the + * **Access the group**: You can access the associated `FormGroup` using the * {@link AbstractControl#get get} method. Ex: `this.form.get('name')`. * * You can also access individual controls within the group using dot syntax. * Ex: `this.form.get('name.first')` * * **Get the value**: the `value` property is always synced and available on the - * {@link FormGroup}. See a full list of available properties in {@link AbstractControl}. + * `FormGroup`. See a full list of available properties in `AbstractControl`. * * **Set the value**: You can set an initial value for each child control when instantiating - * the {@link FormGroup}, or you can set it programmatically later using + * the `FormGroup`, or you can set it programmatically later using * {@link AbstractControl#setValue setValue} or {@link AbstractControl#patchValue patchValue}. * * **Listen to value**: If you want to listen to changes in the value of the group, you can @@ -97,37 +97,37 @@ export const formArrayNameProvider: any = { /** * @description * - * Syncs a nested {@link FormArray} to a DOM element. + * Syncs a nested `FormArray` to a DOM element. * - * This directive is designed to be used with a parent {@link FormGroupDirective} (selector: + * This directive is designed to be used with a parent `FormGroupDirective` (selector: * `[formGroup]`). * - * It accepts the string name of the nested {@link FormArray} you want to link, and - * will look for a {@link FormArray} registered with that name in the parent - * {@link FormGroup} instance you passed into {@link FormGroupDirective}. + * It accepts the string name of the nested `FormArray` you want to link, and + * will look for a `FormArray` registered with that name in the parent + * `FormGroup` instance you passed into `FormGroupDirective`. * * Nested form arrays can come in handy when you have a group of form controls but * you're not sure how many there will be. Form arrays allow you to create new * form controls dynamically. * - * **Access the array**: You can access the associated {@link FormArray} using the - * {@link AbstractControl#get get} method on the parent {@link FormGroup}. + * **Access the array**: You can access the associated `FormArray` using the + * {@link AbstractControl#get get} method on the parent `FormGroup`. * Ex: `this.form.get('cities')`. * * **Get the value**: the `value` property is always synced and available on the - * {@link FormArray}. See a full list of available properties in {@link AbstractControl}. + * `FormArray`. See a full list of available properties in `AbstractControl`. * * **Set the value**: You can set an initial value for each child control when instantiating - * the {@link FormArray}, or you can set the value programmatically later using the - * {@link FormArray}'s {@link AbstractControl#setValue setValue} or + * the `FormArray`, or you can set the value programmatically later using the + * `FormArray`'s {@link AbstractControl#setValue setValue} or * {@link AbstractControl#patchValue patchValue} methods. * * **Listen to value**: If you want to listen to changes in the value of the array, you can - * subscribe to the {@link FormArray}'s {@link AbstractControl#valueChanges valueChanges} event. + * subscribe to the `FormArray`'s {@link AbstractControl#valueChanges valueChanges} event. * You can also listen to its {@link AbstractControl#statusChanges statusChanges} event to be * notified when the validation status is re-calculated. * - * **Add new controls**: You can add new controls to the {@link FormArray} dynamically by calling + * **Add new controls**: You can add new controls to the `FormArray` dynamically by calling * its {@link FormArray#push push} method. * Ex: `this.form.get('cities').push(new FormControl());` * diff --git a/packages/forms/src/directives/select_control_value_accessor.ts b/packages/forms/src/directives/select_control_value_accessor.ts index 919efcbad2..dcd9a5903f 100644 --- a/packages/forms/src/directives/select_control_value_accessor.ts +++ b/packages/forms/src/directives/select_control_value_accessor.ts @@ -31,10 +31,10 @@ function _extractId(valueString: string): string { * * Writes values and listens to changes on a select element. * - * Used by {@link NgModel}, {@link FormControlDirective}, and {@link FormControlName} - * to keep the view synced with the {@link FormControl} model. + * Used by `NgModel`, `FormControlDirective`, and `FormControlName` + * to keep the view synced with the `FormControl` model. * - * If you have imported the {@link FormsModule} or the {@link ReactiveFormsModule}, this + * If you have imported the `FormsModule` or the `ReactiveFormsModule`, this * value accessor will be active on any select control that has a form directive. You do * **not** need to add a special selector to activate it. * @@ -162,7 +162,7 @@ export class SelectControlValueAccessor implements ControlValueAccessor { * * Marks `