mkdocs-material/src/assets/stylesheets/layout/_sidebar.scss

////
/// Copyright (c) 2016-2020 Martin Donath <martin.donath@squidfunk.com>
///
/// Permission is hereby granted, free of charge, to any person obtaining a
/// copy of this software and associated documentation files (the "Software"),
/// to deal in the Software without restriction, including without limitation
/// the rights to use, copy, modify, merge, publish, distribute, sublicense,
/// and/or sell copies of the Software, and to permit persons to whom the
/// Software is furnished to do so, subject to the following conditions:
///
/// The above copyright notice and this permission notice shall be included in
/// all copies or substantial portions of the Software.
///
/// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
/// IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
/// FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL
/// THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
/// LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
/// FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER
/// DEALINGS
////

// ----------------------------------------------------------------------------
// Variables
// ----------------------------------------------------------------------------

// Active (toggled) drawer
$md-toggle__drawer--checked:
  "[data-md-toggle=\"drawer\"]:checked ~ .md-container";

// ----------------------------------------------------------------------------
// Rules
// ----------------------------------------------------------------------------

// Sidebar container
.md-sidebar {
  position: absolute;
  width: px2rem(242px);
  padding: px2rem(24px) 0;
  overflow: hidden;

  // Hide for print
  @media print {
    display: none;
  }

  // Lock sidebar to container height (account for fixed header)
  &[data-md-state="lock"] {
    position: fixed;
    top: px2rem(48px);
  }

  // [tablet -]: Convert navigation to drawer
  @include break-to-device(tablet) {

    // Render primary sidebar as a slideout container
    &--primary {
      position: fixed;
      top: 0;
      left: px2rem(-242px);
      width: px2rem(242px);
      height: 100%;
      transform: translateX(0);
      transition:
        transform  250ms cubic-bezier(0.4, 0, 0.2, 1),
        box-shadow 250ms;
      background-color: var(--md-default-bg-color);
      z-index: 3;

      // Adjust for right-to-left languages
      [dir="rtl"] & {
        right: px2rem(-242px);
        left: initial;
      }

      // Expanded drawer
      #{$md-toggle__drawer--checked} & {
        @include z-depth(8);

        transform: translateX(px2rem(242px));

        // Adjust for right-to-left languages
        [dir="rtl"] & {
          transform: translateX(px2rem(-242px));
        }
      }

      // Hide overflow for nested navigation
      .md-sidebar__scrollwrap {
        overflow: hidden;
      }
    }
  }

  // Secondary sidebar with table of contents
  &--secondary {
    display: none;

    // [tablet landscape +]: Show table of contents next to body copy
    @include break-from-device(tablet landscape) {
      display: block;
      margin-left: calc(100% - #{px2rem(242px)});

      // Adjust for right-to-left languages
      [dir="rtl"] & {
        margin-right: calc(100% - #{px2rem(242px)});
        margin-left: initial;
      }

      // Ensure smooth scrolling on iOS
      .md-sidebar__scrollwrap {
        -webkit-overflow-scrolling: touch;
      }
    }

    // [screen +]: Limit to grid
    @include break-from-device(screen) {
      margin-left: px2rem((1220 - 242) * 1px);

      // Adjust for right-to-left languages
      [dir="rtl"] & {
        margin-right: px2rem((1220 - 242) * 1px);
        margin-left: initial;
      }
    }
  }

  // Wrapper for scrolling on overflow
  &__scrollwrap {
    max-height: 100%;
    margin: 0 px2rem(4px);
    overflow-y: auto;
    scroll-snap-type: y mandatory;
    // Hack: reduce jitter
    backface-visibility: hidden;

    // [tablet -]: Adjust margins
    @include break-to-device(tablet) {

      // Stretch scrollwrap for primary sidebar
      .md-sidebar--primary & {
        position: absolute;
        top: 0;
        right: 0;
        bottom: 0;
        left: 0;
        margin: 0;
        scroll-snap-type: none;
      }
    }

    // Override native scrollbar styles
    &::-webkit-scrollbar {
      width: px2rem(4px);
      height: px2rem(4px);
    }

    // Scrollbar thumb
    &::-webkit-scrollbar-thumb {
      background-color: var(--md-default-fg-color--lighter);

      // Hovered scrollbar thumb
      &:hover {
        background-color: var(--md-accent-fg-color);
      }
    }
  }
}