angular / angular/components

docs-bug(*): Missing migration guide to v19

未关闭
#30,055 18 条评论 34 个 reaction 已指派 1 人 已被 @andrewseguin 认领 在 GitHub 查看
docs needs: discussion
主要语言
TypeScript
星标
25k
派生
6.8k
平均合并
1 天 8 小时
30 天内合并 PR
91

描述

### Documentation Feedback

I'm struggling to migrate from Angular Material v18 (with MD3) to v19. I did not find any migration guide and the new guides do not explain the basics as deeply as in the previous version.

Here are the most important use cases that I don't know how to deal with:

> Note: I'm trying to remove the old `$theme = mat.define-theme(...)` to use the new `@include mat.theme` mixins

## Styling custom components
### Before
```
.my-component {
background-color: mat.get-theme-color(theme.$theme, neutral, 98)
}
```
### After
I cannot use mat.get-theme-color because I don't have a $theme anymore (previously from mat.define-theme). How can I do that?

## Material 3 theme setup
### Before
```
@include mat.core();
:root {
@include mat.core-theme(theme.$light-theme);
}
```

### After
It has been automatically replaced to:

```
@include mat.elevation-classes();
@include mat.app-background();
:root {
@include mat.elevation-classes();
@include mat.app-background();
}
```
What is it for? Why isn't it present if I create a new application with Angular Material? Should it be duplicated? I don't see any documentation mentioning those mixins.

## Customising material components
### Before
I could do this:
```
@include mat.chips-color(theme.$theme, $color-variant: primary);
@include mat.form-field-density(-3);
```

### After
How to do the same? Do I need to use the new overrides mixins and set each color tokens? For example, that would be 25 colors for the chip component.

### Affected documentation page

https://material.angular.io/guide/theming

贡献指南

打开贡献指南

评估

这个 Issue 还没有评估数据。

把新 issue 发到你的邮箱

精选适合新手参与的 GitHub issue 摘要。