diff --git a/guides/mat-elevation.md b/guides/mat-elevation.md new file mode 100644 index 000000000000..eacd655eb0b3 --- /dev/null +++ b/guides/mat-elevation.md @@ -0,0 +1,33 @@ +# mat-elevation +mat-elevation exists to give you separation between elements. +All material design elements have resting elevations. +[`Material design`](https://material.io/guidelines/material-design/elevation-shadows.html) +explains how best to use elevation. + + +Elevation is implemented with a class, simply adding the class `mat-elevation-z#` where # is the elevation number you want, 0-24. + +## Example + + + +## Mixins +In order to use the mixin for Elevation you must +`@import '~@angular/material/theming';` +$zValue must be a value between 0 and 24, inclusive. +`@include mat-elevation($zValue);` + + +How to use the mixin +```scss +.myClass { + @include mat-elevation(2); + + &:active { + @include mat-elevation(8); + } +} +``` + +## Deprecated +The `mdElevation($zValue)` directive is deprecated. \ No newline at end of file diff --git a/src/examples/elevation-overview/elevation-overview-example.html b/src/examples/elevation-overview/elevation-overview-example.html new file mode 100644 index 000000000000..15da6028893b --- /dev/null +++ b/src/examples/elevation-overview/elevation-overview-example.html @@ -0,0 +1,5 @@ +