Skip to content

Commit e2c1d00

Browse files
thesmilerthePunderWoman
authored andcommitted
docs: replace material.a.io with material.a.dev (angular#61513)
PR Close angular#61513
1 parent a62d3e7 commit e2c1d00

16 files changed

+29
-29
lines changed

README.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -137,7 +137,7 @@ Join the conversation and help the community.
137137
[changelog]: CHANGELOG.md
138138
[ng]: https://angular.dev
139139
[documentation]: https://angular.dev/overview
140-
[angularmaterial]: https://material.angular.io/
140+
[angularmaterial]: https://material.angular.dev/
141141
[cli]: https://angular.dev/tools/cli
142142
[architecture]: https://angular.dev/essentials
143143
[componentstemplates]: https://angular.dev/tutorials/learn-angular/1-components-in-angular

adev/src/app/features/update/recommendations.ts

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1822,7 +1822,7 @@ export const RECOMMENDATIONS: Step[] = [
18221822
material: true,
18231823
step: 'v15 mat refactor',
18241824
action:
1825-
'In Angular Material v15, many of the components have been refactored to be based on the official Material Design Components for Web (MDC). This change affected the DOM and CSS classes of many components. <a href="https://rc.material.angular.io/guide/mdc-migration" alt="Link to more information about this change">Read further</a>',
1825+
'In Angular Material v15, many of the components have been refactored to be based on the official Material Design Components for Web (MDC). This change affected the DOM and CSS classes of many components. <a href="https://rc.material.angular.dev/guide/mdc-migration" alt="Link to more information about this change">Read further</a>',
18261826
},
18271827
{
18281828
possibleIn: 1500,

adev/src/app/sub-navigation-data.ts

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -897,11 +897,11 @@ const DOCS_SUB_NAVIGATION_DATA: NavigationItem[] = [
897897
},
898898
{
899899
label: 'Angular CDK',
900-
path: 'https://material.angular.io/cdk/categories',
900+
path: 'https://material.angular.dev/cdk/categories',
901901
},
902902
{
903903
label: 'Angular Material',
904-
path: 'https://material.angular.io/',
904+
path: 'https://material.angular.dev/',
905905
},
906906
],
907907
},

adev/src/content/best-practices/a11y.md

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -36,8 +36,8 @@ See the [Binding syntax guide](guide/templates) for more background on the diffe
3636

3737
## Angular UI components
3838

39-
The [Angular Material](https://material.angular.io) library, which is maintained by the Angular team, is a suite of reusable UI components that aims to be fully accessible.
40-
The [Component Development Kit (CDK)](https://material.angular.io/cdk/categories) includes the `a11y` package that provides tools to support various areas of accessibility.
39+
The [Angular Material](https://material.angular.dev) library, which is maintained by the Angular team, is a suite of reusable UI components that aims to be fully accessible.
40+
The [Component Development Kit (CDK)](https://material.angular.dev/cdk/categories) includes the `a11y` package that provides tools to support various areas of accessibility.
4141
For example:
4242

4343
* `LiveAnnouncer` is used to announce messages for screen-reader users using an `aria-live` region.
@@ -46,7 +46,7 @@ For example:
4646
* The `cdkTrapFocus` directive traps Tab-key focus within an element.
4747
Use it to create accessible experience for components such as modal dialogs, where focus must be constrained.
4848

49-
For full details of these and other tools, see the [Angular CDK accessibility overview](https://material.angular.io/cdk/a11y/overview).
49+
For full details of these and other tools, see the [Angular CDK accessibility overview](https://material.angular.dev/cdk/a11y/overview).
5050

5151
### Augmenting native elements
5252

@@ -66,7 +66,7 @@ For example, the native `<input>` element cannot have children, so any custom te
6666
By just including `<input>` in your custom component's template, it's impossible for your component's users to set arbitrary properties and attributes to the `<input>` element.
6767
Instead, create a container component that uses content projection to include the native control in the component's API.
6868

69-
You can see [`MatFormField`](https://material.angular.io/components/form-field/overview) as an example of this pattern.
69+
You can see [`MatFormField`](https://material.angular.dev/components/form-field/overview) as an example of this pattern.
7070

7171
## Case study: Building a custom progress bar
7272

adev/src/content/guide/drag-drop.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -17,7 +17,7 @@ For the full API reference, please see the [Angular CDK's drag and drop API refe
1717

1818
### CDK Installation
1919

20-
The [Component Dev Kit (CDK)](https://material.angular.io/cdk/categories) is a set of behavior primitives for building components. To use the drag and drop directives, first install `@angular/cdk` from npm. You can do this from your terminal using Angular CLI:
20+
The [Component Dev Kit (CDK)](https://material.angular.dev/cdk/categories) is a set of behavior primitives for building components. To use the drag and drop directives, first install `@angular/cdk` from npm. You can do this from your terminal using Angular CLI:
2121

2222
<docs-code language="shell">
2323
ng add @angular/cdk

adev/src/content/guide/templates/ng-template.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -279,5 +279,5 @@ For more details, see [Structural Directives](/guide/directives/structural-direc
279279

280280
For examples of how `ng-template` is used in other libraries, check out:
281281

282-
- [Tabs from Angular Material](https://material.angular.io/components/tabs/overview) - nothing gets rendered into the DOM until the tab is activated
283-
- [Table from Angular Material](https://material.angular.io/components/table/overview) - allows developers to define different ways to render data
282+
- [Tabs from Angular Material](https://material.angular.dev/components/tabs/overview) - nothing gets rendered into the DOM until the tab is activated
283+
- [Table from Angular Material](https://material.angular.dev/components/table/overview) - allows developers to define different ways to render data

adev/src/content/guide/testing/component-harnesses-overview.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -16,7 +16,7 @@ it('should load button with exact text', async () => {
1616
});
1717
</docs-code>
1818

19-
Component harnesses are especially useful for shared UI widgets. Developers often write tests that depend on private implementation details of widgets, such as DOM structure and CSS classes. Those dependencies make tests brittle and hard to maintain. Harnesses offer an alternative— a supported API that interacts with the widget the same way an end-user does. Widget implementation changes now become less likely to break user tests. For example, [Angular Material](https://material.angular.io/components/categories) provides a test harness for each component in the library.
19+
Component harnesses are especially useful for shared UI widgets. Developers often write tests that depend on private implementation details of widgets, such as DOM structure and CSS classes. Those dependencies make tests brittle and hard to maintain. Harnesses offer an alternative— a supported API that interacts with the widget the same way an end-user does. Widget implementation changes now become less likely to break user tests. For example, [Angular Material](https://material.angular.dev/components/categories) provides a test harness for each component in the library.
2020

2121
Component harnesses support multiple testing environments. You can use the same harness implementation in both unit and end-to-end tests. Test authors only need to learn one API and component authors don't have to maintain separate unit and end-to-end test implementations.
2222

adev/src/content/guide/testing/component-harnesses-testing-environments.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -17,7 +17,7 @@ Otherwise, to add support for other environments, you need to define how to inte
1717

1818
### CDK Installation
1919

20-
The [Component Dev Kit (CDK)](https://material.angular.io/cdk/categories) is a set of behavior primitives for building components. To use the component harnesses, first install `@angular/cdk` from npm. You can do this from your terminal using the Angular CLI:
20+
The [Component Dev Kit (CDK)](https://material.angular.dev/cdk/categories) is a set of behavior primitives for building components. To use the component harnesses, first install `@angular/cdk` from npm. You can do this from your terminal using the Angular CLI:
2121

2222
<docs-code language="shell">
2323
ng add @angular/cdk

adev/src/content/guide/testing/creating-component-harnesses.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -12,7 +12,7 @@ For components that appear in only one place, such as a page in an application,
1212

1313
### CDK Installation
1414

15-
The [Component Dev Kit (CDK)](https://material.angular.io/cdk/categories) is a set of behavior primitives for building components. To use the component harnesses, first install `@angular/cdk` from npm. You can do this from your terminal using the Angular CLI:
15+
The [Component Dev Kit (CDK)](https://material.angular.dev/cdk/categories) is a set of behavior primitives for building components. To use the component harnesses, first install `@angular/cdk` from npm. You can do this from your terminal using the Angular CLI:
1616

1717
<docs-code language="shell">
1818
ng add @angular/cdk

adev/src/content/guide/testing/using-component-harnesses.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -6,7 +6,7 @@ TIP: This guide assumes you've already read the [component harnesses overview gu
66

77
### CDK Installation
88

9-
The [Component Dev Kit (CDK)](https://material.angular.io/cdk/categories) is a set of behavior primitives for building components. To use the component harnesses, first install `@angular/cdk` from npm. You can do this from your terminal using the Angular CLI:
9+
The [Component Dev Kit (CDK)](https://material.angular.dev/cdk/categories) is a set of behavior primitives for building components. To use the component harnesses, first install `@angular/cdk` from npm. You can do this from your terminal using the Angular CLI:
1010

1111
<docs-code language="shell">
1212
ng add @angular/cdk
@@ -155,7 +155,7 @@ While every harness defines an API specific to its corresponding component, they
155155

156156
Beyond that, the API of any given harness is specific to its corresponding component; refer to the component's documentation to learn how to use a specific harness.
157157

158-
As an example, the following is a test for a component that uses the [Angular Material slider component harness](https://material.angular.io/components/slider/api#MatSliderHarness):
158+
As an example, the following is a test for a component that uses the [Angular Material slider component harness](https://material.angular.dev/components/slider/api#MatSliderHarness):
159159

160160
<docs-code language="typescript">
161161
it('should get value of slider thumb', async () => {

adev/src/content/reference/roadmap.md

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -71,7 +71,7 @@ Start developing with the latest Angular features from our roadmap. This list re
7171

7272
<docs-card-container>
7373
<docs-card title="New CDK primitives" href="">
74-
We are working on new CDK primitives to facilitate creating custom components based on the WAI-ARIA design patterns for [Combobox](https://www.w3.org/TR/wai-aria-practices-1.1/#combobox). Angular v14 introduced stable [menu and dialog primitives](https://material.angular.io/cdk/categories) as part of this project, and in v15 Listbox.
74+
We are working on new CDK primitives to facilitate creating custom components based on the WAI-ARIA design patterns for [Combobox](https://www.w3.org/TR/wai-aria-practices-1.1/#combobox). Angular v14 introduced stable [menu and dialog primitives](https://material.angular.dev/cdk/categories) as part of this project, and in v15 Listbox.
7575
</docs-card>
7676
<docs-card title="Angular component accessibility" href="">
7777
We are evaluating components in Angular Material against accessibility standards such as WCAG and working to fix any issues that arise from this process.
@@ -157,7 +157,7 @@ This section represents explorations and prototyping of potential future project
157157
<docs-card title="Local template variables" link="Completed in Q3 2024">
158158
We've released the support for local template variables in Angular, see [`@let` docs](https://angular.dev/api/core/@let) for additional information.
159159
</docs-card>
160-
<docs-card title="Expand the customizability of Angular Material" link="Completed in Q2 2024" href="https://material.angular.io/guide/theming">
160+
<docs-card title="Expand the customizability of Angular Material" link="Completed in Q2 2024" href="https://material.angular.dev/guide/theming">
161161
To provide better customization of our Angular Material components and enable Material 3 capabilities, we'll be collaborating with Google's Material Design team on defining token-based theming APIs.
162162

163163
In v17.2 we shared experimental support for Angular Material 3 and in v18 we graduated it to stable.
@@ -215,7 +215,7 @@ This section represents explorations and prototyping of potential future project
215215
<docs-card title="Better stack traces" link="Completed Q4 2022" href="https://developer.chrome.com/blog/devtools-better-angular-debugging/">
216216
The Angular and the Chrome DevTools are working together to enable more readable stack traces for error messages. In v15 we released improved relevant and linked stack traces. As a lower priority initiative, we'll be exploring how to make the stack traces friendlier by providing more accurate call frame names for templates.
217217
</docs-card>
218-
<docs-card title="Enhanced Angular Material components by integrating MDC Web" link="Completed Q4 2022" href="https://material.angular.io/guide/mdc-migration">
218+
<docs-card title="Enhanced Angular Material components by integrating MDC Web" link="Completed Q4 2022" href="https://material.angular.dev/guide/mdc-migration">
219219
MDC Web is a library created by the Google Material Design team that provides reusable primitives for building Material Design components. The Angular team is incorporating these primitives into Angular Material. Using MDC Web aligns Angular Material more closely with the Material Design specification, expands accessibility, improves component quality, and improves the velocity of our team.
220220
</docs-card>
221221
<docs-card title="Implement APIs for optional NgModules" link="Completed Q4 2022" href="https://blog.angular.dev/angular-v15-is-now-available-df7be7f2f4c8">
@@ -287,7 +287,7 @@ This section represents explorations and prototyping of potential future project
287287
<docs-card title="Improved developer onboarding with refreshed introductory documentation" link="Completed Q1 2021" href="tutorials">
288288
We will redefine the user learning journeys and refresh the introductory documentation. We will clearly state the benefits of Angular, how to explore its capabilities and provide guidance so developers can become proficient with the framework in as little time as possible.
289289
</docs-card>
290-
<docs-card title="Expand component harnesses best practices" link="Completed Q1 2021" href="https://material.angular.io/guide/using-component-harnesses">
290+
<docs-card title="Expand component harnesses best practices" link="Completed Q1 2021" href="https://material.angular.dev/guide/using-component-harnesses">
291291
Angular CDK introduced the concept of component test harnesses to Angular in version 9. Test harnesses let component authors create supported APIs for testing component interactions. We are continuing to improve this harness infrastructure and clarifying the best practices around using harnesses. We are also working to drive more harness adoption inside of Google.
292292
</docs-card>
293293
<docs-card title="Author a guide for content projection" link="Completed Q2 2021" href="https://angular.io/docs">

adev/src/content/tools/cli/schematics.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -62,7 +62,7 @@ For more details of what these look like and how to create them, see:
6262
An *add schematic* is typically supplied with a library, so that the library can be added to an existing project with `ng add`.
6363
The `add` command uses your package manager to download new dependencies, and invokes an installation script that is implemented as a schematic.
6464

65-
For example, the [`@angular/material`](https://material.angular.io/guide/schematics) schematic tells the `add` command to install and set up Angular Material and theming, and register new starter components that can be created with `ng generate`.
65+
For example, the [`@angular/material`](https://material.angular.dev/guide/schematics) schematic tells the `add` command to install and set up Angular Material and theming, and register new starter components that can be created with `ng generate`.
6666
Look at this one as an example and model for your own add schematic.
6767

6868
Partner and third party libraries also support the Angular CLI with add schematics.

adev/src/content/tools/libraries/creating-libraries.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -108,7 +108,7 @@ A library typically includes *reusable code* that defines components, services,
108108
A library is packaged into an npm package for publishing and sharing.
109109
This package can also include schematics that provide instructions for generating or transforming code directly in your project, in the same way that the CLI creates a generic new component with `ng generate component`.
110110
A schematic that is packaged with a library can, for example, provide the Angular CLI with the information it needs to generate a component that configures and uses a particular feature, or set of features, defined in that library.
111-
One example of this is [Angular Material's navigation schematic](https://material.angular.io/guide/schematics#navigation-schematic) which configures the CDK's [BreakpointObserver](https://material.angular.io/cdk/layout/overview#breakpointobserver) and uses it with Material's [MatSideNav](https://material.angular.io/components/sidenav/overview) and [MatToolbar](https://material.angular.io/components/toolbar/overview) components.
111+
One example of this is [Angular Material's navigation schematic](https://material.angular.dev/guide/schematics#navigation-schematic) which configures the CDK's [BreakpointObserver](https://material.angular.dev/cdk/layout/overview#breakpointobserver) and uses it with Material's [MatSideNav](https://material.angular.dev/components/sidenav/overview) and [MatToolbar](https://material.angular.dev/components/toolbar/overview) components.
112112

113113
Create and include the following kinds of schematics:
114114

adev/src/content/tools/libraries/overview.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -10,7 +10,7 @@ A library must be imported and used in an application.
1010
Libraries extend Angular's base features.
1111
For example, to add [reactive forms](guide/forms/reactive-forms) to an application, add the library package using `ng add @angular/forms`, then import the `ReactiveFormsModule` from the `@angular/forms` library in your application code.
1212
Similarly, adding the [service worker](ecosystem/service-workers) library to an Angular application is one of the steps for turning an application into a [Progressive Web App](https://developers.google.com/web/progressive-web-apps) \(PWA\).
13-
[Angular Material](https://material.angular.io) is an example of a large, general-purpose library that provides sophisticated, reusable, and adaptable UI components.
13+
[Angular Material](https://material.angular.dev) is an example of a large, general-purpose library that provides sophisticated, reusable, and adaptable UI components.
1414

1515
Any application developer can use these and other libraries that have been published as npm packages by the Angular team or by third parties.
1616
See [Using Published Libraries](tools/libraries/using-libraries).

adev/src/content/tools/libraries/using-libraries.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -59,7 +59,7 @@ To do this:
5959
<docs-code language="typescript">
6060

6161
import * as host from 'host';
62-
const parsedUrl = host.parse('https://angular.io');
62+
const parsedUrl = host.parse('https://angular.dev');
6363
console.log(parsedUrl.hostname);
6464

6565
</docs-code>
@@ -184,7 +184,7 @@ If you do not add the interface for the script-defined extension, your IDE shows
184184

185185
[Resources]: resources "Explore Angular Resources | Angular"
186186

187-
[AngularMaterialMain]: https://material.angular.io "Angular Material | Angular"
187+
[AngularMaterialMain]: https://material.angular.dev "Angular Material | Angular"
188188

189189
[AngularUpdateMain]: https://angular.dev/update-guide "Angular Update Guide | Angular"
190190

0 commit comments

Comments
 (0)