angular / angular/components

docs-bug(core): Missing documentation about elevation since v19.1

Offen
#30,918 3 Kommentare 2 Reaktionen 0 zugewiesene Personen Auf GitHub ansehen
area: material/core docs P3
Vorherrschende Sprache
TypeScript
Sterne
25k
Forks
6.8k
Ø Merge
1 T. 8 Std.
Gemergte PRs (30 T.)
91

Beschreibung

### Documentation Feedback

In v18, we had https://v18.material.angular.io/guide/elevation that documented in depth what is, and how to use, elevations in Material.

Since 5753ce24a3e3bf743a9fc9f471eff46b85a7817b, and v19.1 that content is declared to have been moved to https://material.angular.io/guide/theming. However that new page does not even include the term "elevation" at all. So we cannot even know whether classes such as `mat-elevation-z2` are still supported, and even less how to make them work (via `@include mat.elevation-classes();`).

If this is something that has been deprecated (which does not seems to be the case when reading code), then it should at least be mentioned as such. Otherwise the original documentation should be restored.

Would you accept a PR that restore previous documentation, but included on the new https://material.angular.io/guide/theming ?

### Affected documentation page

https://v18.material.angular.io/guide/elevation

Beitragsleitfaden

Beitragsleitfaden öffnen

Rechercherichtung

Beginne mit dem Vergleich des Elevation-Leitfadens für v18 mit der aktuellen Theming-Seite. Untersuche anschließend die referenzierte Dokumentationsänderung und die Codepfade für Elevation-Klassen sowie das Mixin mat.elevation-classes(). Die Aufgabe ist erledigt, wenn die Theming-Dokumentation die aktuelle Elevation-Unterstützung und deren Verwendung erklärt oder ihre Einstellung ausdrücklich dokumentiert und die betroffene Seite entsprechend aktualisiert ist.

Vom Indexierungsmodell aus dem Issue-Text verfasst.

Bewertung

Tech-Stack
angular
Bereich
documentation
Issue-Typ
Dokumentation
Schwierigkeit
2/5
Geschätzter Aufwand
1-3 Stunden
Aktivitätsstatus
Veraltet
Klarheit
Größtenteils klar
Anfängerfreundlichkeit
35/100

Neue Issues direkt in Ihr Postfach

Eine kurze Übersicht über anfängerfreundliche GitHub-Issues.