Add elevation guide #2800

Splaktar · 2017-01-25T18:43:47Z

Bug, feature request, or proposal:

proposal

What is the expected behavior?

That .md-elevation-zX classes are documented.

What is the current behavior?

No documentation exists other than within closed PR and issue comments. There are some design documents, but they aren't really designed for developers using the APIs.

What is the use-case or motivation for changing an existing behavior?

To avoid repeated questions and rejected PRs like #2212.

Is there anything else we should know?

I would like to help with this documentation, but I would like some feedback on how the team would like this to be done before I submit a PR.

Should there be a separate doc/guide for elevation that covers examples of multiple components?

Should there be examples of using elevation in each component that it applies to?
Is there a list of such components?

The text was updated successfully, but these errors were encountered:

jelbourn · 2017-01-25T19:24:20Z

It would be great to have a short and simple guide on elevation in the guides/ directory.

ladyleet · 2017-01-25T20:01:40Z

agreed would be fabulous! // @EladBezalel (thx @Splaktar!) I like the simplicity of MaterializeCSS docs http://materializecss.com/shadow.html

farantesrodrigues · 2017-02-02T16:14:09Z

Mixins like @include md-elevation($zValue); should also be documented. In the design documents this is mdElevation($zValue) which I assume is deprecated.

rviveiros · 2017-03-09T17:31:12Z

Now we should use @include mat-elevation($zValue);

M-a-c · 2017-03-31T21:51:03Z

@Splaktar Do you have a Pr in progress that I could help with or anything like that, I've got my own branch open on my fork, wasn't sure if you had started.

Splaktar · 2017-04-12T20:42:47Z

@M-a-c no sorry. I had other priorities jump up and haven't had a chance to get back to this. Thank you for helping out!

ghost · 2017-07-26T16:00:26Z

I have a problem with hundreds of elevation directives being injected in for EVERY component. Every components has CSS styles like this:

.mat-elevation-z0 {
  box-shadow: 0px 0px 0px 0px rgba(0, 0, 0, 0.2), 0px 0px 0px 0px rgba(0, 0, 0, 0.14), 0px 0px 0px 0px rgba(0, 0, 0, 0.12); }

.mat-elevation-z1 {
  box-shadow: 0px 2px 1px -1px rgba(0, 0, 0, 0.2), 0px 1px 1px 0px rgba(0, 0, 0, 0.14), 0px 1px 3px 0px rgba(0, 0, 0, 0.12); }

.mat-elevation-z2 {
  box-shadow: 0px 3px 1px -2px rgba(0, 0, 0, 0.2), 0px 2px 2px 0px rgba(0, 0, 0, 0.14), 0px 1px 5px 0px rgba(0, 0, 0, 0.12); }

.mat-elevation-z3 {
  box-shadow: 0px 3px 3px -2px rgba(0, 0, 0, 0.2), 0px 3px 4px 0px rgba(0, 0, 0, 0.14), 0px 1px 8px 0px rgba(0, 0, 0, 0.12); }

.mat-elevation-z4 {
  box-shadow: 0px 2px 4px -1px rgba(0, 0, 0, 0.2), 0px 4px 5px 0px rgba(0, 0, 0, 0.14), 0px 1px 10px 0px rgba(0, 0, 0, 0.12); }

.mat-elevation-z5 {
  box-shadow: 0px 3px 5px -1px rgba(0, 0, 0, 0.2), 0px 5px 8px 0px rgba(0, 0, 0, 0.14), 0px 1px 14px 0px rgba(0, 0, 0, 0.12); }

.mat-elevation-z6 {
  box-shadow: 0px 3px 5px -1px rgba(0, 0, 0, 0.2), 0px 6px 10px 0px rgba(0, 0, 0, 0.14), 0px 1px 18px 0px rgba(0, 0, 0, 0.12); }

.mat-elevation-z7 {
  box-shadow: 0px 4px 5px -2px rgba(0, 0, 0, 0.2), 0px 7px 10px 1px rgba(0, 0, 0, 0.14), 0px 2px 16px 1px rgba(0, 0, 0, 0.12); }

.mat-elevation-z8 {
  box-shadow: 0px 5px 5px -3px rgba(0, 0, 0, 0.2), 0px 8px 10px 1px rgba(0, 0, 0, 0.14), 0px 3px 14px 2px rgba(0, 0, 0, 0.12); }

.mat-elevation-z9 {
  box-shadow: 0px 5px 6px -3px rgba(0, 0, 0, 0.2), 0px 9px 12px 1px rgba(0, 0, 0, 0.14), 0px 3px 16px 2px rgba(0, 0, 0, 0.12); }

.mat-elevation-z10 {
  box-shadow: 0px 6px 6px -3px rgba(0, 0, 0, 0.2), 0px 10px 14px 1px rgba(0, 0, 0, 0.14), 0px 4px 18px 3px rgba(0, 0, 0, 0.12); }

.mat-elevation-z11 {
  box-shadow: 0px 6px 7px -4px rgba(0, 0, 0, 0.2), 0px 11px 15px 1px rgba(0, 0, 0, 0.14), 0px 4px 20px 3px rgba(0, 0, 0, 0.12); }

.mat-elevation-z12 {
  box-shadow: 0px 7px 8px -4px rgba(0, 0, 0, 0.2), 0px 12px 17px 2px rgba(0, 0, 0, 0.14), 0px 5px 22px 4px rgba(0, 0, 0, 0.12); }

.mat-elevation-z13 {
  box-shadow: 0px 7px 8px -4px rgba(0, 0, 0, 0.2), 0px 13px 19px 2px rgba(0, 0, 0, 0.14), 0px 5px 24px 4px rgba(0, 0, 0, 0.12); }

.mat-elevation-z14 {
  box-shadow: 0px 7px 9px -4px rgba(0, 0, 0, 0.2), 0px 14px 21px 2px rgba(0, 0, 0, 0.14), 0px 5px 26px 4px rgba(0, 0, 0, 0.12); }

.mat-elevation-z15 {
  box-shadow: 0px 8px 9px -5px rgba(0, 0, 0, 0.2), 0px 15px 22px 2px rgba(0, 0, 0, 0.14), 0px 6px 28px 5px rgba(0, 0, 0, 0.12); }

.mat-elevation-z16 {
  box-shadow: 0px 8px 10px -5px rgba(0, 0, 0, 0.2), 0px 16px 24px 2px rgba(0, 0, 0, 0.14), 0px 6px 30px 5px rgba(0, 0, 0, 0.12); }

and

.mat-elevation-z0[_ngcontent-c18] {
  box-shadow: 0px 0px 0px 0px rgba(0, 0, 0, 0.2), 0px 0px 0px 0px rgba(0, 0, 0, 0.14), 0px 0px 0px 0px rgba(0, 0, 0, 0.12); }

.mat-elevation-z1[_ngcontent-c18] {
  box-shadow: 0px 2px 1px -1px rgba(0, 0, 0, 0.2), 0px 1px 1px 0px rgba(0, 0, 0, 0.14), 0px 1px 3px 0px rgba(0, 0, 0, 0.12); }

.mat-elevation-z2[_ngcontent-c18] {
  box-shadow: 0px 3px 1px -2px rgba(0, 0, 0, 0.2), 0px 2px 2px 0px rgba(0, 0, 0, 0.14), 0px 1px 5px 0px rgba(0, 0, 0, 0.12); }

.mat-elevation-z3[_ngcontent-c18] {
  box-shadow: 0px 3px 3px -2px rgba(0, 0, 0, 0.2), 0px 3px 4px 0px rgba(0, 0, 0, 0.14), 0px 1px 8px 0px rgba(0, 0, 0, 0.12); }

.mat-elevation-z4[_ngcontent-c18] {
  box-shadow: 0px 2px 4px -1px rgba(0, 0, 0, 0.2), 0px 4px 5px 0px rgba(0, 0, 0, 0.14), 0px 1px 10px 0px rgba(0, 0, 0, 0.12); }

.mat-elevation-z5[_ngcontent-c18] {
  box-shadow: 0px 3px 5px -1px rgba(0, 0, 0, 0.2), 0px 5px 8px 0px rgba(0, 0, 0, 0.14), 0px 1px 14px 0px rgba(0, 0, 0, 0.12); }

.mat-elevation-z6[_ngcontent-c18] {
  box-shadow: 0px 3px 5px -1px rgba(0, 0, 0, 0.2), 0px 6px 10px 0px rgba(0, 0, 0, 0.14), 0px 1px 18px 0px rgba(0, 0, 0, 0.12); }

.mat-elevation-z7[_ngcontent-c18] {
  box-shadow: 0px 4px 5px -2px rgba(0, 0, 0, 0.2), 0px 7px 10px 1px rgba(0, 0, 0, 0.14), 0px 2px 16px 1px rgba(0, 0, 0, 0.12); }

.mat-elevation-z8[_ngcontent-c18] {
  box-shadow: 0px 5px 5px -3px rgba(0, 0, 0, 0.2), 0px 8px 10px 1px rgba(0, 0, 0, 0.14), 0px 3px 14px 2px rgba(0, 0, 0, 0.12); }

.mat-elevation-z9[_ngcontent-c18] {
  box-shadow: 0px 5px 6px -3px rgba(0, 0, 0, 0.2), 0px 9px 12px 1px rgba(0, 0, 0, 0.14), 0px 3px 16px 2px rgba(0, 0, 0, 0.12); }

.mat-elevation-z10[_ngcontent-c18] {
  box-shadow: 0px 6px 6px -3px rgba(0, 0, 0, 0.2), 0px 10px 14px 1px rgba(0, 0, 0, 0.14), 0px 4px 18px 3px rgba(0, 0, 0, 0.12); }

.mat-elevation-z11[_ngcontent-c18] {
  box-shadow: 0px 6px 7px -4px rgba(0, 0, 0, 0.2), 0px 11px 15px 1px rgba(0, 0, 0, 0.14), 0px 4px 20px 3px rgba(0, 0, 0, 0.12); }

.mat-elevation-z12[_ngcontent-c18] {
  box-shadow: 0px 7px 8px -4px rgba(0, 0, 0, 0.2), 0px 12px 17px 2px rgba(0, 0, 0, 0.14), 0px 5px 22px 4px rgba(0, 0, 0, 0.12); }

.mat-elevation-z13[_ngcontent-c18] {
  box-shadow: 0px 7px 8px -4px rgba(0, 0, 0, 0.2), 0px 13px 19px 2px rgba(0, 0, 0, 0.14), 0px 5px 24px 4px rgba(0, 0, 0, 0.12); }

.mat-elevation-z14[_ngcontent-c18] {
  box-shadow: 0px 7px 9px -4px rgba(0, 0, 0, 0.2), 0px 14px 21px 2px rgba(0, 0, 0, 0.14), 0px 5px 26px 4px rgba(0, 0, 0, 0.12); }

.mat-elevation-z15[_ngcontent-c18] {
  box-shadow: 0px 8px 9px -5px rgba(0, 0, 0, 0.2), 0px 15px 22px 2px rgba(0, 0, 0, 0.14), 0px 6px 28px 5px rgba(0, 0, 0, 0.12); }

.mat-elevation-z16[_ngcontent-c18] {
  box-shadow: 0px 8px 10px -5px rgba(0, 0, 0, 0.2), 0px 16px 24px 2px rgba(0, 0, 0, 0.14), 0px 6px 30px 5px rgba(0, 0, 0, 0.12); }

.mat-elevation-z17[_ngcontent-c18] {
  box-shadow: 0px 8px 11px -5px rgba(0, 0, 0, 0.2), 0px 17px 26px 2px rgba(0, 0, 0, 0.14), 0px 6px 32px 5px rgba(0, 0, 0, 0.12); }

.mat-elevation-z18[_ngcontent-c18] {
  box-shadow: 0px 9px 11px -5px rgba(0, 0, 0, 0.2), 0px 18px 28px 2px rgba(0, 0, 0, 0.14), 0px 7px 34px 6px rgba(0, 0, 0, 0.12); }

.mat-elevation-z19[_ngcontent-c18] {
  box-shadow: 0px 9px 12px -6px rgba(0, 0, 0, 0.2), 0px 19px 29px 2px rgba(0, 0, 0, 0.14), 0px 7px 36px 6px rgba(0, 0, 0, 0.12); }

.mat-elevation-z20[_ngcontent-c18] {
  box-shadow: 0px 10px 13px -6px rgba(0, 0, 0, 0.2), 0px 20px 31px 3px rgba(0, 0, 0, 0.14), 0px 8px 38px 7px rgba(0, 0, 0, 0.12); }

.mat-elevation-z21[_ngcontent-c18] {
  box-shadow: 0px 10px 13px -6px rgba(0, 0, 0, 0.2), 0px 21px 33px 3px rgba(0, 0, 0, 0.14), 0px 8px 40px 7px rgba(0, 0, 0, 0.12); }

.mat-elevation-z22[_ngcontent-c18] {
  box-shadow: 0px 10px 14px -6px rgba(0, 0, 0, 0.2), 0px 22px 35px 3px rgba(0, 0, 0, 0.14), 0px 8px 42px 7px rgba(0, 0, 0, 0.12); }

.mat-elevation-z23[_ngcontent-c18] {
  box-shadow: 0px 11px 14px -7px rgba(0, 0, 0, 0.2), 0px 23px 36px 3px rgba(0, 0, 0, 0.14), 0px 9px 44px 8px rgba(0, 0, 0, 0.12); }

.mat-elevation-z24[_ngcontent-c18] {
  box-shadow: 0px 11px 15px -7px rgba(0, 0, 0, 0.2), 0px 24px 38px 3px rgba(0, 0, 0, 0.14), 0px 9px 46px 8px rgba(0, 0, 0, 0.12); }

.mat-h1[_ngcontent-c18], .mat-headline[_ngcontent-c18], .mat-typography[_ngcontent-c18]   h1[_ngcontent-c18] {
  font: 400 24px/32px Roboto, "Helvetica Neue", sans-serif;
  margin: 0 0 16px; }

How do I turn this off?

willshowell · 2017-07-26T16:07:15Z

@megamindbrian You are probably indirectly including mat-core in each component

ghost · 2017-07-26T19:11:41Z

@willshowell Thanks for the response! I only included mat-core 1 time in my "layout.scss". I've added "layout.scss" to angular-cli.json:

{
    "apps": [
        {
            "name": "my-app",
            ... main, polyfills, etc
            "styles": [
                "layout.scss"
            ]
        }
    ]
}

I've just confirmed layout.scss is not referenced anywhere else in the project, only angular-cli.json.
Here is a screenshot of the inspector, as you can see there are A DOZEN <style> tags.

angular-automatic-lock-bot · 2019-09-07T13:02:11Z

This issue has been automatically locked due to inactivity.
Please file a new issue if you are encountering a similar or related problem.

Read more about our automatic conversation locking policy.

_{This action has been performed automatically by a bot.}

jelbourn added docs This issue is related to documentation help wanted The team would appreciate a PR from the community to address this issue labels Jan 27, 2017

M-a-c mentioned this issue Apr 5, 2017

Docs (Guides): Mat elevation guide #3917

Closed

jelbourn changed the title ~~docs(md-elevation): request for feedback on approach~~ Add elevation guide Jun 6, 2017

jelbourn added feature This issue represents a new feature or feature request rather than a bug or bug fix has pr labels Jun 6, 2017

willshowell mentioned this issue Jul 26, 2017

Theme documentation doesn't work #6063

Closed

willshowell mentioned this issue Nov 1, 2017

docs(elevation): add guide for elevation helpers #8172

Merged

andrewseguin closed this as completed in #8172 Nov 2, 2017

angular-automatic-lock-bot bot locked and limited conversation to collaborators Sep 7, 2019

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Add elevation guide #2800

Add elevation guide #2800

Splaktar commented Jan 25, 2017 •

edited

Loading

jelbourn commented Jan 25, 2017

ladyleet commented Jan 25, 2017

farantesrodrigues commented Feb 2, 2017 •

edited

Loading

rviveiros commented Mar 9, 2017

M-a-c commented Mar 31, 2017 •

edited

Loading

Splaktar commented Apr 12, 2017

ghost commented Jul 26, 2017 •

edited by ghost

Loading

willshowell commented Jul 26, 2017

ghost commented Jul 26, 2017

angular-automatic-lock-bot bot commented Sep 7, 2019

Add elevation guide #2800

Add elevation guide #2800

Comments

Splaktar commented Jan 25, 2017 • edited Loading

Bug, feature request, or proposal:

What is the expected behavior?

What is the current behavior?

What is the use-case or motivation for changing an existing behavior?

Is there anything else we should know?

jelbourn commented Jan 25, 2017

ladyleet commented Jan 25, 2017

farantesrodrigues commented Feb 2, 2017 • edited Loading

rviveiros commented Mar 9, 2017

M-a-c commented Mar 31, 2017 • edited Loading

Splaktar commented Apr 12, 2017

ghost commented Jul 26, 2017 • edited by ghost Loading

willshowell commented Jul 26, 2017

ghost commented Jul 26, 2017

angular-automatic-lock-bot bot commented Sep 7, 2019

Splaktar commented Jan 25, 2017 •

edited

Loading

farantesrodrigues commented Feb 2, 2017 •

edited

Loading

M-a-c commented Mar 31, 2017 •

edited

Loading

ghost commented Jul 26, 2017 •

edited by ghost

Loading