diff --git a/goldens/public-api/common/index.api.md b/goldens/public-api/common/index.api.md index 16e86935ea2..1de8d8a2a35 100644 --- a/goldens/public-api/common/index.api.md +++ b/goldens/public-api/common/index.api.md @@ -516,7 +516,7 @@ export class NgComponentOutlet implements OnChanges, DoCheck, OnDestroy static ɵfac: i0.ɵɵFactoryDeclaration, never>; } -// @public +// @public @deprecated class NgForOf = NgIterable> implements DoCheck { constructor(_viewContainer: ViewContainerRef, _template: TemplateRef>, _differs: IterableDiffers); ngDoCheck(): void; @@ -534,7 +534,7 @@ class NgForOf = NgIterable> implements DoCheck { export { NgForOf as NgFor } export { NgForOf } -// @public (undocumented) +// @public @deprecated (undocumented) export class NgForOfContext = NgIterable> { $implicit: T; constructor( @@ -555,7 +555,7 @@ export class NgForOfContext = NgIterable> { get odd(): boolean; } -// @public +// @public @deprecated export class NgIf { constructor(_viewContainer: ViewContainerRef, templateRef: TemplateRef>); set ngIf(condition: T); @@ -682,7 +682,7 @@ export class NgStyle implements DoCheck { static ɵfac: i0.ɵɵFactoryDeclaration; } -// @public +// @public @deprecated export class NgSwitch { // (undocumented) set ngSwitch(newValue: any); diff --git a/packages/common/src/directives/ng_for_of.ts b/packages/common/src/directives/ng_for_of.ts index 70129bc07c5..8794a0bf8f9 100644 --- a/packages/common/src/directives/ng_for_of.ts +++ b/packages/common/src/directives/ng_for_of.ts @@ -26,6 +26,8 @@ import {RuntimeErrorCode} from '../errors'; /** * @publicApi + * + * @deprecated The `ngFor` directive is deprecated. Use the `@for` block instead. */ export class NgForOfContext = NgIterable> { constructor( @@ -164,6 +166,8 @@ export class NgForOfContext = NgIterable> { * @see [Structural Directives](guide/directives/structural-directives) * @ngModule CommonModule * @publicApi + * + * @deprecated Use the @for block instead. Intent to remove in v22 */ @Directive({ selector: '[ngFor][ngForOf]', diff --git a/packages/common/src/directives/ng_if.ts b/packages/common/src/directives/ng_if.ts index d90e575923b..3b21c3bfa0e 100644 --- a/packages/common/src/directives/ng_if.ts +++ b/packages/common/src/directives/ng_if.ts @@ -156,6 +156,8 @@ import {RuntimeErrorCode} from '../errors'; * * @ngModule CommonModule * @publicApi + * + * @deprecated Use the @if block instead. Intent to remove in v22 */ @Directive({ selector: '[ngIf]', diff --git a/packages/common/src/directives/ng_switch.ts b/packages/common/src/directives/ng_switch.ts index 1ad19b45f12..b2139afe4a7 100644 --- a/packages/common/src/directives/ng_switch.ts +++ b/packages/common/src/directives/ng_switch.ts @@ -111,6 +111,7 @@ export class SwitchView { * @see {@link NgSwitchDefault} * @see [Structural Directives](guide/directives/structural-directives) * + * @deprecated Use the @switch block instead. Intent to remove in v22 */ @Directive({ selector: '[ngSwitch]', @@ -196,6 +197,7 @@ export class NgSwitch { * @see {@link NgSwitch} * @see {@link NgSwitchDefault} * + * @deprecated Use the @case block within a @switch block instead. Intent to remove in v22 */ @Directive({ selector: '[ngSwitchCase]', @@ -242,6 +244,7 @@ export class NgSwitchCase implements DoCheck { * @see {@link NgSwitch} * @see {@link NgSwitchCase} * + * @deprecated Use the @default block within a @switch block instead. Intent to remove in v22 */ @Directive({ selector: '[ngSwitchDefault]',