/* * Copyright (C) 2022 The Android Open Source Project * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ @use '@angular/cdk'; $drawer-content-z-index: 1; $drawer-side-drawer-z-index: 2; $drawer-backdrop-z-index: 3; $drawer-over-drawer-z-index: 4; // Mixin that creates a new stacking context. // see https://developer.mozilla.org/en-US/docs/Web/CSS/CSS_Positioning/Understanding_z_index/The_stacking_context @mixin drawer-stacking-context($z-index: 1) { position: relative; // Use a z-index to create a new stacking context. (We can't use transform because it breaks fixed // positioning inside of the transformed element). z-index: $z-index; } .mat-drawer-container { // We need a stacking context here so that the backdrop and drawers are clipped to the // MatDrawerContainer. This creates a new z-index stack so we use low numbered z-indices. // We create another stacking context in the '.mat-drawer-content' and in each drawer so that // the application content does not get messed up with our own CSS. @include drawer-stacking-context(); box-sizing: border-box; -webkit-overflow-scrolling: touch; // Need this to take up space in the layout. display: block; // Hide the drawers when they're closed. overflow: hidden; // TODO(hansl): Update this with a more robust solution. &[fullscreen] { top: 0; left: 0; right: 0; bottom: 0; position: absolute; &.mat-drawer-container-has-open { overflow: hidden; } } // When the consumer explicitly enabled the backdrop, // we have to pull the side drawers above it. &.mat-drawer-container-explicit-backdrop .mat-drawer-side { z-index: $drawer-backdrop-z-index; } // Note that the `NoopAnimationsModule` is being handled inside of the component code. &.ng-animate-disabled, .ng-animate-disabled & { .mat-drawer-backdrop, .mat-drawer-content { transition: none; } } } .mat-drawer-backdrop { top: 0; left: 0; right: 0; bottom: 0; position: absolute; display: block; // Because of the new stacking context, the z-index stack is new and we can use our own // numbers. z-index: $drawer-backdrop-z-index; // We use 'visibility: hidden | visible' because 'display: none' will not animate any // transitions, while visibility will interpolate transitions properly. // see https://developer.mozilla.org/en-US/docs/Web/CSS/visibility, the Interpolation // section. visibility: hidden; &.mat-drawer-shown { visibility: visible; } .mat-drawer-transition & { transition: { duration: 400ms; timing-function: cubic-bezier(0.25, 0.8, 0.25, 1); property: background-color, visibility; } } @include cdk.high-contrast(active, off) { opacity: 0.5; } } .mat-drawer-content { @include drawer-stacking-context($drawer-content-z-index); display: block; height: 100%; overflow: auto; .mat-drawer-transition & { transition: { duration: 400ms; timing-function: cubic-bezier(0.25, 0.8, 0.25, 1); property: transform, margin-left, margin-right; } } } .mat-drawer { $high-contrast-border: solid 1px currentColor; @include drawer-stacking-context($drawer-over-drawer-z-index); display: block; position: absolute; top: 0; bottom: 0; z-index: 3; outline: 0; box-sizing: border-box; overflow-y: auto; // TODO(kara): revisit scrolling behavior for drawers transform: translate3d(-100%, 0, 0); &, [dir='rtl'] &.mat-drawer-end { @include cdk.high-contrast(active, off) { border-right: $high-contrast-border; } } [dir='rtl'] &, &.mat-drawer-end { @include cdk.high-contrast(active, off) { border-left: $high-contrast-border; border-right: none; } } &.mat-drawer-side { z-index: $drawer-side-drawer-z-index; } &.mat-drawer-end { right: 0; transform: translate3d(100%, 0, 0); } [dir='rtl'] & { transform: translate3d(100%, 0, 0); &.mat-drawer-end { left: 0; right: auto; transform: translate3d(-100%, 0, 0); } } // Usually the `visibility: hidden` added by the animation is enough to prevent focus from // entering the hidden drawer content, but children with their own `visibility` can override it. // This is a fallback that completely hides the content when the element becomes hidden. // Note that we can't do this in the animation definition, because the style gets recomputed too // late, breaking the animation because Angular didn't have time to figure out the target // transform. This can also be achieved with JS, but it has issues when starting an // animation before the previous one has finished. &[style*='visibility: hidden'] { display: none; } } // Note that this div isn't strictly necessary on all browsers, however we need it in // order to avoid a layout issue in Chrome. The issue is that in RTL mode the browser doesn't // account for the sidenav's scrollbar while positioning, which ends up pushing it partially // out of the screen. We work around the issue by having the scrollbar be on this inner container. .mat-drawer-inner-container { width: 100%; height: 100%; overflow: auto; -webkit-overflow-scrolling: touch; } .mat-sidenav-fixed { position: fixed; }