diff --git a/src/material/legacy-button/button-module.ts b/src/material/legacy-button/button-module.ts index b8744cb7cbf2..910ccbc7fa63 100644 --- a/src/material/legacy-button/button-module.ts +++ b/src/material/legacy-button/button-module.ts @@ -10,6 +10,10 @@ import {NgModule} from '@angular/core'; import {MatCommonModule, MatRippleModule} from '@angular/material/core'; import {MatLegacyAnchor, MatLegacyButton} from './button'; +/** + * @deprecated Use `MatButtonModule` from `@angular/material/button` instead. See https://material.angular.io/guide/mdc-migration for information about migrating. + * @breaking-change 17.0.0 + */ @NgModule({ imports: [MatRippleModule, MatCommonModule], exports: [MatLegacyButton, MatLegacyAnchor, MatCommonModule], diff --git a/src/material/legacy-button/button.ts b/src/material/legacy-button/button.ts index 25f863c81011..d75802dc4f72 100644 --- a/src/material/legacy-button/button.ts +++ b/src/material/legacy-button/button.ts @@ -61,6 +61,8 @@ const _MatButtonBase = mixinColor( /** * Material design button. + * @deprecated Use `MatButton` from `@angular/material/button` instead. See https://material.angular.io/guide/mdc-migration for information about migrating. + * @breaking-change 17.0.0 */ @Component({ selector: `button[mat-button], button[mat-raised-button], button[mat-icon-button], @@ -153,6 +155,8 @@ export class MatLegacyButton /** * Material design anchor button. + * @deprecated Use `MatAnchor` from `@angular/material/button` instead. See https://material.angular.io/guide/mdc-migration for information about migrating. + * @breaking-change 17.0.0 */ @Component({ selector: `a[mat-button], a[mat-raised-button], a[mat-icon-button], a[mat-fab], diff --git a/src/material/legacy-button/testing/button-harness-filters.ts b/src/material/legacy-button/testing/button-harness-filters.ts index f7892efbd5a9..d8e923b1064d 100644 --- a/src/material/legacy-button/testing/button-harness-filters.ts +++ b/src/material/legacy-button/testing/button-harness-filters.ts @@ -8,7 +8,11 @@ import {BaseHarnessFilters} from '@angular/cdk/testing'; -/** A set of criteria that can be used to filter a list of button harness instances. */ +/** + * A set of criteria that can be used to filter a list of button harness instances. + * @deprecated Use `ButtonHarnessFilters` from `@angular/material/button/testing` instead. See https://material.angular.io/guide/mdc-migration for information about migrating. + * @breaking-change 17.0.0 + */ export interface LegacyButtonHarnessFilters extends BaseHarnessFilters { /** Only find instances whose text matches the given value. */ text?: string | RegExp; diff --git a/src/material/legacy-button/testing/button-harness.ts b/src/material/legacy-button/testing/button-harness.ts index d70918068ee6..7d337ed8ed5e 100644 --- a/src/material/legacy-button/testing/button-harness.ts +++ b/src/material/legacy-button/testing/button-harness.ts @@ -10,7 +10,11 @@ import {ContentContainerComponentHarness, HarnessPredicate} from '@angular/cdk/t import {coerceBooleanProperty} from '@angular/cdk/coercion'; import {LegacyButtonHarnessFilters} from './button-harness-filters'; -/** Harness for interacting with a standard mat-button in tests. */ +/** + * Harness for interacting with a standard mat-button in tests. + * @deprecated Use `MatButtonHarness` from `@angular/material/button/testing` instead. See https://material.angular.io/guide/mdc-migration for information about migrating. + * @breaking-change 17.0.0 + */ export class MatLegacyButtonHarness extends ContentContainerComponentHarness { // TODO(jelbourn) use a single class, like `.mat-button-base` /** The selector for the host element of a button instance. */ diff --git a/tools/public_api_guard/material/legacy-button-testing.md b/tools/public_api_guard/material/legacy-button-testing.md index ff088425861c..94c682b7d9ba 100644 --- a/tools/public_api_guard/material/legacy-button-testing.md +++ b/tools/public_api_guard/material/legacy-button-testing.md @@ -8,12 +8,12 @@ import { BaseHarnessFilters } from '@angular/cdk/testing'; import { ContentContainerComponentHarness } from '@angular/cdk/testing'; import { HarnessPredicate } from '@angular/cdk/testing'; -// @public +// @public @deprecated export interface LegacyButtonHarnessFilters extends BaseHarnessFilters { text?: string | RegExp; } -// @public +// @public @deprecated export class MatLegacyButtonHarness extends ContentContainerComponentHarness { blur(): Promise; click(relativeX: number, relativeY: number): Promise; diff --git a/tools/public_api_guard/material/legacy-button.md b/tools/public_api_guard/material/legacy-button.md index 73e202d2456e..6fd46b5ca517 100644 --- a/tools/public_api_guard/material/legacy-button.md +++ b/tools/public_api_guard/material/legacy-button.md @@ -20,7 +20,7 @@ import { MatRipple } from '@angular/material/core'; import { NgZone } from '@angular/core'; import { OnDestroy } from '@angular/core'; -// @public +// @public @deprecated export class MatLegacyAnchor extends MatLegacyButton implements AfterViewInit, OnDestroy { constructor(focusMonitor: FocusMonitor, elementRef: ElementRef, animationMode: string, _ngZone?: NgZone | undefined); @@ -37,7 +37,7 @@ export class MatLegacyAnchor extends MatLegacyButton implements AfterViewInit, O static ɵfac: i0.ɵɵFactoryDeclaration; } -// @public +// @public @deprecated export class MatLegacyButton extends _MatButtonBase implements AfterViewInit, OnDestroy, CanDisable, CanColor, CanDisableRipple, FocusableOption { constructor(elementRef: ElementRef, _focusMonitor: FocusMonitor, _animationMode: string); // (undocumented) @@ -61,7 +61,7 @@ export class MatLegacyButton extends _MatButtonBase implements AfterViewInit, On static ɵfac: i0.ɵɵFactoryDeclaration; } -// @public (undocumented) +// @public @deprecated (undocumented) export class MatLegacyButtonModule { // (undocumented) static ɵfac: i0.ɵɵFactoryDeclaration;