Skip to content

Commit 4e56db6

Browse files
committed
fix(material/legacy-menu): deprecate all ts symbols
1 parent e67e493 commit 4e56db6

File tree

10 files changed

+98
-11
lines changed

10 files changed

+98
-11
lines changed

src/material/legacy-menu/menu-content.ts

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -11,6 +11,8 @@ import {MAT_MENU_CONTENT, _MatMenuContentBase} from '@angular/material/menu';
1111

1212
/**
1313
* Menu content that will be rendered lazily once the menu is opened.
14+
* @deprecated Use `MatMenuContent` from `@angular/material/menu` instead. See https://material.angular.io/guide/mdc-migration for information about migrating.
15+
* @breaking-change 17.0.0
1416
*/
1517
@Directive({
1618
selector: 'ng-template[matMenuContent]',

src/material/legacy-menu/menu-item.ts

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -11,6 +11,8 @@ import {MatMenuItem as BaseMatMenuItem} from '@angular/material/menu';
1111

1212
/**
1313
* Single item inside of a `mat-menu`. Provides the menu item styling and accessibility treatment.
14+
* @deprecated Use `MatMenuItem` from `@angular/material/menu` instead. See https://material.angular.io/guide/mdc-migration for information about migrating.
15+
* @breaking-change 17.0.0
1416
*/
1517
@Component({
1618
selector: '[mat-menu-item]',

src/material/legacy-menu/menu-module.ts

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -17,6 +17,10 @@ import {MatLegacyMenuContent} from './menu-content';
1717
import {MatLegacyMenuItem} from './menu-item';
1818
import {MatLegacyMenuTrigger} from './menu-trigger';
1919

20+
/**
21+
* @deprecated Use `MatMenuModule` from `@angular/material/menu` instead. See https://material.angular.io/guide/mdc-migration for information about migrating.
22+
* @breaking-change 17.0.0
23+
*/
2024
@NgModule({
2125
imports: [CommonModule, MatCommonModule, MatRippleModule, OverlayModule],
2226
exports: [

src/material/legacy-menu/menu-trigger.ts

Lines changed: 5 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -11,7 +11,11 @@ import {_MatMenuTriggerBase} from '@angular/material/menu';
1111

1212
// TODO(andrewseguin): Remove the kebab versions in favor of camelCased attribute selectors
1313

14-
/** Directive applied to an element that should trigger a `mat-menu`. */
14+
/**
15+
* Directive applied to an element that should trigger a `mat-menu`.
16+
* @deprecated Use `MatMenuTrigger` from `@angular/material/menu` instead. See https://material.angular.io/guide/mdc-migration for information about migrating.
17+
* @breaking-change 17.0.0
18+
*/
1519
@Directive({
1620
selector: `[mat-menu-trigger-for], [matMenuTriggerFor]`,
1721
host: {

src/material/legacy-menu/menu.ts

Lines changed: 5 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -23,7 +23,11 @@ import {
2323
MatMenuDefaultOptions,
2424
} from '@angular/material/menu';
2525

26-
/** @docs-public MatMenu */
26+
/**
27+
* @docs-public MatMenu
28+
* @deprecated Use `MatMenu` from `@angular/material/menu` instead. See https://material.angular.io/guide/mdc-migration for information about migrating.
29+
* @breaking-change 17.0.0
30+
*/
2731
@Component({
2832
selector: 'mat-menu',
2933
templateUrl: 'menu.html',

src/material/legacy-menu/public-api.ts

Lines changed: 54 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -13,15 +13,69 @@ export {MatLegacyMenuModule} from './menu-module';
1313
export {MatLegacyMenuContent} from './menu-content';
1414

1515
export {
16+
/**
17+
* @deprecated Use `fadeInItems` from `@angular/material/menu` instead. See https://material.angular.io/guide/mdc-migration for information about migrating.
18+
* @breaking-change 17.0.0
19+
*/
1620
fadeInItems as fadeInLegacyItems,
21+
22+
/**
23+
* @deprecated Use `MAT_MENU_DEFAULT_OPTIONS` from `@angular/material/menu` instead. See https://material.angular.io/guide/mdc-migration for information about migrating.
24+
* @breaking-change 17.0.0
25+
*/
1726
MAT_MENU_DEFAULT_OPTIONS as MAT_LEGACY_MENU_DEFAULT_OPTIONS,
27+
28+
/**
29+
* @deprecated Use `MAT_MENU_PANEL` from `@angular/material/menu` instead. See https://material.angular.io/guide/mdc-migration for information about migrating.
30+
* @breaking-change 17.0.0
31+
*/
1832
MAT_MENU_PANEL as MAT_LEGACY_MENU_PANEL,
33+
34+
/**
35+
* @deprecated Use `MAT_MENU_SCROLL_STRATEGY` from `@angular/material/menu` instead. See https://material.angular.io/guide/mdc-migration for information about migrating.
36+
* @breaking-change 17.0.0
37+
*/
1938
MAT_MENU_SCROLL_STRATEGY as MAT_LEGACY_MENU_SCROLL_STRATEGY,
39+
40+
/**
41+
* @deprecated Use `matMenuAnimations` from `@angular/material/menu` instead. See https://material.angular.io/guide/mdc-migration for information about migrating.
42+
* @breaking-change 17.0.0
43+
*/
2044
matMenuAnimations as matLegacyMenuAnimations,
45+
46+
/**
47+
* @deprecated Use `MatMenuDefaultOptions` from `@angular/material/menu` instead. See https://material.angular.io/guide/mdc-migration for information about migrating.
48+
* @breaking-change 17.0.0
49+
*/
2150
MatMenuDefaultOptions as MatLegacyMenuDefaultOptions,
51+
52+
/**
53+
* @deprecated Use `MatMenuPanel` from `@angular/material/menu` instead. See https://material.angular.io/guide/mdc-migration for information about migrating.
54+
* @breaking-change 17.0.0
55+
*/
2256
MatMenuPanel as MatLegacyMenuPanel,
57+
58+
/**
59+
* @deprecated Use `MenuPositionX` from `@angular/material/menu` instead. See https://material.angular.io/guide/mdc-migration for information about migrating.
60+
* @breaking-change 17.0.0
61+
*/
2362
MenuPositionX as LegacyMenuPositionX,
63+
64+
/**
65+
* @deprecated Use `MenuPositionY` from `@angular/material/menu` instead. See https://material.angular.io/guide/mdc-migration for information about migrating.
66+
* @breaking-change 17.0.0
67+
*/
2468
MenuPositionY as LegacyMenuPositionY,
69+
70+
/**
71+
* @deprecated Use `transformMenu` from `@angular/material/menu` instead. See https://material.angular.io/guide/mdc-migration for information about migrating.
72+
* @breaking-change 17.0.0
73+
*/
2574
transformMenu as transformLegacyMenu,
75+
76+
/**
77+
* @deprecated Use `MAT_MENU_CONTENT` from `@angular/material/menu` instead. See https://material.angular.io/guide/mdc-migration for information about migrating.
78+
* @breaking-change 17.0.0
79+
*/
2680
MAT_MENU_CONTENT as MAT_LEGACY_MENU_CONTENT,
2781
} from '@angular/material/menu';

src/material/legacy-menu/testing/menu-harness.ts

Lines changed: 10 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -14,7 +14,11 @@ import {
1414
_MatMenuItemHarnessBase,
1515
} from '@angular/material/menu/testing';
1616

17-
/** Harness for interacting with a standard mat-menu in tests. */
17+
/**
18+
* Harness for interacting with a standard mat-menu in tests.
19+
* @deprecated Use `MatMenuHarness` from `@angular/material/menu/testing` instead. See https://material.angular.io/guide/mdc-migration for information about migrating.
20+
* @breaking-change 17.0.0
21+
*/
1822
export class MatLegacyMenuHarness extends _MatMenuHarnessBase<
1923
typeof MatLegacyMenuItemHarness,
2024
MatLegacyMenuItemHarness,
@@ -39,7 +43,11 @@ export class MatLegacyMenuHarness extends _MatMenuHarnessBase<
3943
}
4044
}
4145

42-
/** Harness for interacting with a standard mat-menu-item in tests. */
46+
/**
47+
* Harness for interacting with a standard mat-menu-item in tests.
48+
* @deprecated Use `MatMenuItemHarness` from `@angular/material/menu/testing` instead. See https://material.angular.io/guide/mdc-migration for information about migrating.
49+
* @breaking-change 17.0.0
50+
*/
4351
export class MatLegacyMenuItemHarness extends _MatMenuItemHarnessBase<
4452
typeof MatLegacyMenuHarness,
4553
MatLegacyMenuHarness

src/material/legacy-menu/testing/public-api.ts

Lines changed: 9 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -8,6 +8,15 @@
88

99
export {MatLegacyMenuHarness, MatLegacyMenuItemHarness} from './menu-harness';
1010
export {
11+
/**
12+
* @deprecated Use `MenuHarnessFilters` from `@angular/material/menu/testing` instead. See https://material.angular.io/guide/mdc-migration for information about migrating.
13+
* @breaking-change 17.0.0
14+
*/
1115
MenuHarnessFilters as LegacyMenuHarnessFilters,
16+
17+
/**
18+
* @deprecated Use `MenuItemHarnessFilters` from `@angular/material/menu/testing` instead. See https://material.angular.io/guide/mdc-migration for information about migrating.
19+
* @breaking-change 17.0.0
20+
*/
1221
MenuItemHarnessFilters as LegacyMenuItemHarnessFilters,
1322
} from '@angular/material/menu/testing';

tools/public_api_guard/material/legacy-menu-testing.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -14,15 +14,15 @@ export { LegacyMenuHarnessFilters }
1414

1515
export { LegacyMenuItemHarnessFilters }
1616

17-
// @public
17+
// @public @deprecated
1818
export class MatLegacyMenuHarness extends _MatMenuHarnessBase<typeof MatLegacyMenuItemHarness, MatLegacyMenuItemHarness, LegacyMenuItemHarnessFilters> {
1919
static hostSelector: string;
2020
// (undocumented)
2121
protected _itemClass: typeof MatLegacyMenuItemHarness;
2222
static with(options?: LegacyMenuHarnessFilters): HarnessPredicate<MatLegacyMenuHarness>;
2323
}
2424

25-
// @public
25+
// @public @deprecated
2626
export class MatLegacyMenuItemHarness extends _MatMenuItemHarnessBase<typeof MatLegacyMenuHarness, MatLegacyMenuHarness> {
2727
static hostSelector: string;
2828
// (undocumented)

tools/public_api_guard/material/legacy-menu.md

Lines changed: 5 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -41,7 +41,7 @@ export { MAT_LEGACY_MENU_PANEL }
4141

4242
export { MAT_LEGACY_MENU_SCROLL_STRATEGY }
4343

44-
// @public
44+
// @public @deprecated
4545
export class MatLegacyMenu extends _MatMenuBase {
4646
// @deprecated
4747
constructor(elementRef: ElementRef<HTMLElement>, ngZone: NgZone, defaultOptions: MatLegacyMenuDefaultOptions);
@@ -57,7 +57,7 @@ export class MatLegacyMenu extends _MatMenuBase {
5757

5858
export { matLegacyMenuAnimations }
5959

60-
// @public
60+
// @public @deprecated
6161
export class MatLegacyMenuContent extends _MatMenuContentBase {
6262
// (undocumented)
6363
static ɵdir: i0.ɵɵDirectiveDeclaration<MatLegacyMenuContent, "ng-template[matMenuContent]", never, {}, {}, never, never, false>;
@@ -67,15 +67,15 @@ export class MatLegacyMenuContent extends _MatMenuContentBase {
6767

6868
export { MatLegacyMenuDefaultOptions }
6969

70-
// @public
70+
// @public @deprecated
7171
export class MatLegacyMenuItem extends MatMenuItem {
7272
// (undocumented)
7373
static ɵcmp: i0.ɵɵComponentDeclaration<MatLegacyMenuItem, "[mat-menu-item]", ["matMenuItem"], { "disabled": "disabled"; "disableRipple": "disableRipple"; }, {}, never, ["*"], false>;
7474
// (undocumented)
7575
static ɵfac: i0.ɵɵFactoryDeclaration<MatLegacyMenuItem, never>;
7676
}
7777

78-
// @public (undocumented)
78+
// @public @deprecated (undocumented)
7979
export class MatLegacyMenuModule {
8080
// (undocumented)
8181
static ɵfac: i0.ɵɵFactoryDeclaration<MatLegacyMenuModule, never>;
@@ -87,7 +87,7 @@ export class MatLegacyMenuModule {
8787

8888
export { MatLegacyMenuPanel }
8989

90-
// @public
90+
// @public @deprecated
9191
export class MatLegacyMenuTrigger extends _MatMenuTriggerBase {
9292
// (undocumented)
9393
static ɵdir: i0.ɵɵDirectiveDeclaration<MatLegacyMenuTrigger, "[mat-menu-trigger-for], [matMenuTriggerFor]", ["matMenuTrigger"], {}, {}, never, never, false>;

0 commit comments

Comments
 (0)