_popover.scss

// Popover from carbon-components@10.47 (removed in 10.48), with the Carbon
// v11 caret, drop shadow and border.

@import "carbon-components/scss/globals/scss/vars";
@import "carbon-components/scss/globals/scss/helper-mixins";
@import "carbon-components/scss/globals/scss/vendor/@carbon/elements/scss/import-once/import-once";

/// Popover component
/// @access private
/// @group components
@mixin popover {
  $popover-text-color: $text-primary;

  .#{$prefix}--popover {
    // Specify the distance between the popover and the trigger. This value must
    // have a unit otherwise the `calc()` expression will not work
    // stylelint-disable-next-line length-zero-no-unit
    --cds-popover-offset: 0rem;

    --cds-popover-caret-offset: 1rem;

    position: absolute;
    z-index: z("floating");
    display: none;
  }

  // We use a pseudo element inside of the popover to create a space between the
  // target and the popover. This helps in situations like tooltips where you do
  // not want the tooltip to disappear when the user moves from the target to
  // the popover.
  .#{$prefix}--popover::before {
    position: absolute;
    display: block;
    content: "";
  }

  .#{$prefix}--popover--open {
    display: block;
  }

  // A popover in a portal: the portal places it, so its side class only
  // draws the caret. A margin on the side facing the anchor keeps the gap
  // that `--cds-popover-offset` gives in place. The classes are physical.
  .#{$prefix}--popover.#{$prefix}--popover--portal {
    position: relative;
    inset: auto;
    transform: none;
  }

  @each $side, $facing, $edges in (top bottom (left, right), bottom top (left, right), left right (top, bottom), right left (top, bottom)) {
    .#{$prefix}--popover--portal.#{$prefix}--popover--#{$side},
    .#{$prefix}--popover--portal.#{$prefix}--popover--#{$side}-#{nth($edges, 1)},
    .#{$prefix}--popover--portal.#{$prefix}--popover--#{$side}-#{nth($edges, 2)} {
      margin-#{$facing}: var(--cds-popover-offset);
    }
  }

  .#{$prefix}--popover-contents {
    // The shadow is the only edge; forced colors drop it.
    @include high-contrast-mode("outline");

    position: relative;
    width: max-content;
    max-width: to-rem(368px);
    background-color: $layer;
    border-radius: 2px;
    color: $popover-text-color;
  }

  // v11 draws the shadow as a filter on the whole popover, so it follows the
  // caret too. Toggletip keeps the v10 box-shadow (see the end of this mixin).
  .#{$prefix}--popover--drop-shadow:not(.#{$prefix}--toggletip-popover) {
    filter: drop-shadow(0 $carbon--spacing-01 $carbon--spacing-01 rgba(0, 0, 0, 0.2));
  }

  .#{$prefix}--popover--border .#{$prefix}--popover-contents {
    outline: 1px solid $border-subtle;
    outline-offset: -1px;
  }

  .#{$prefix}--popover--high-contrast .#{$prefix}--popover-contents {
    background-color: $background-inverse;
    color: $text-inverse;
  }

  .#{$prefix}--popover--bottom {
    bottom: 0;
    left: 50%;
    transform: translate(-50%, calc(100% + var(--cds-popover-offset)));
  }

  .#{$prefix}--popover--bottom-left {
    bottom: 0;
    left: 0;
    transform: translateY(calc(100% + var(--cds-popover-offset)));
  }

  .#{$prefix}--popover--bottom-right {
    right: 0;
    bottom: 0;
    transform: translateY(calc(100% + var(--cds-popover-offset)));
  }

  .#{$prefix}--popover--bottom::before,
  .#{$prefix}--popover--bottom-left::before,
  .#{$prefix}--popover--bottom-right::before {
    top: 0;
    right: 0;
    left: 0;
    height: var(--cds-popover-offset);
    transform: translateY(-100%);
  }

  .#{$prefix}--popover--top {
    bottom: 100%;
    left: 50%;
    transform: translate(-50%, calc(-1 * var(--cds-popover-offset)));
  }

  .#{$prefix}--popover--top-left {
    bottom: 100%;
    left: 0;
    transform: translateY(calc(-1 * var(--cds-popover-offset)));
  }

  .#{$prefix}--popover--top-right {
    right: 0;
    bottom: 100%;
    transform: translateY(calc(-1 * var(--cds-popover-offset)));
  }

  .#{$prefix}--popover--top::before,
  .#{$prefix}--popover--top-left::before,
  .#{$prefix}--popover--top-right::before {
    right: 0;
    bottom: 0;
    left: 0;
    height: var(--cds-popover-offset);
    transform: translateY(100%);
  }

  .#{$prefix}--popover--right {
    top: 50%;
    left: 100%;
    transform: translate(var(--cds-popover-offset), -50%);
  }

  .#{$prefix}--popover--right-top {
    top: 0;
    left: 100%;
    transform: translateX(var(--cds-popover-offset));
  }

  .#{$prefix}--popover--right-bottom {
    bottom: 0;
    left: 100%;
    transform: translateX(var(--cds-popover-offset));
  }

  .#{$prefix}--popover--right::before,
  .#{$prefix}--popover--right-top::before,
  .#{$prefix}--popover--right-bottom::before {
    top: 0;
    bottom: 0;
    left: 0;
    width: var(--cds-popover-offset);
    transform: translateX(-100%);
  }

  .#{$prefix}--popover--left {
    top: 50%;
    right: 100%;
    transform: translate(calc(-1 * var(--cds-popover-offset)), -50%);
  }

  .#{$prefix}--popover--left-top {
    top: 0;
    right: 100%;
    transform: translateX(calc(-1 * var(--cds-popover-offset)));
  }

  .#{$prefix}--popover--left-bottom {
    right: 100%;
    bottom: 0;
    transform: translateX(calc(-1 * var(--cds-popover-offset)));
  }

  .#{$prefix}--popover--left::before,
  .#{$prefix}--popover--left-top::before,
  .#{$prefix}--popover--left-bottom::before {
    top: 0;
    right: 0;
    bottom: 0;
    width: var(--cds-popover-offset);
    transform: translateX(100%);
  }

  // The v11 caret: a 12px x 6px triangle outside the contents' edge, 10px off
  // the trigger. A start or end caret centers where the v10 caret did,
  // `--cds-popover-caret-offset` plus 4px in from the corner. Each placement
  // sets the caret's position, shape and shift on the popover, so one rule
  // draws it. `::before` is the 1px edge that `border` and forced colors draw
  // under it; there `::after` moves 1px in and narrows by 1px.
  $caret-center: calc(var(--cds-popover-caret-offset) + #{to-rem(4px)});
  $caret-end: calc(100% - var(--cds-popover-caret-offset) - #{to-rem(4px)});

  .#{$prefix}--popover--bottom,
  .#{$prefix}--popover--bottom-left,
  .#{$prefix}--popover--bottom-right {
    --ccs-popover-caret-y: 0;
    --ccs-popover-caret-shift: translate(-50%, -100%);
    --ccs-popover-caret-width: #{to-rem(12px)};
    --ccs-popover-caret-height: #{to-rem(6px)};
    --ccs-popover-caret-shape: polygon(0 100%, 50% 0, 100% 100%);
    --ccs-popover-caret-inner: polygon(0.5px 100%, 50% 0, calc(100% - 0.5px) 100%);
    --ccs-popover-caret-edge: 1px 0 0;
  }

  .#{$prefix}--popover--top,
  .#{$prefix}--popover--top-left,
  .#{$prefix}--popover--top-right {
    --ccs-popover-caret-y: 100%;
    --ccs-popover-caret-shift: translateX(-50%);
    --ccs-popover-caret-width: #{to-rem(12px)};
    --ccs-popover-caret-height: #{to-rem(6px)};
    --ccs-popover-caret-shape: polygon(0 0, 50% 100%, 100% 0);
    --ccs-popover-caret-inner: polygon(0.5px 0, 50% 100%, calc(100% - 0.5px) 0);
    --ccs-popover-caret-edge: -1px 0 0;
  }

  .#{$prefix}--popover--right,
  .#{$prefix}--popover--right-top,
  .#{$prefix}--popover--right-bottom {
    --ccs-popover-caret-x: 0;
    --ccs-popover-caret-shift: translate(-100%, -50%);
    --ccs-popover-caret-width: #{to-rem(6px)};
    --ccs-popover-caret-height: #{to-rem(12px)};
    --ccs-popover-caret-shape: polygon(100% 0, 0 50%, 100% 100%);
    --ccs-popover-caret-inner: polygon(100% 0.5px, 0 50%, 100% calc(100% - 0.5px));
    --ccs-popover-caret-edge: 0 0 0 1px;
  }

  .#{$prefix}--popover--left,
  .#{$prefix}--popover--left-top,
  .#{$prefix}--popover--left-bottom {
    --ccs-popover-caret-x: 100%;
    --ccs-popover-caret-shift: translateY(-50%);
    --ccs-popover-caret-width: #{to-rem(6px)};
    --ccs-popover-caret-height: #{to-rem(12px)};
    --ccs-popover-caret-shape: polygon(0 0, 100% 50%, 0 100%);
    --ccs-popover-caret-inner: polygon(0 0.5px, 100% 50%, 0 calc(100% - 0.5px));
    --ccs-popover-caret-edge: 0 0 0 -1px;
  }

  .#{$prefix}--popover--bottom,
  .#{$prefix}--popover--top {
    --ccs-popover-caret-x: 50%;
  }

  .#{$prefix}--popover--bottom-left,
  .#{$prefix}--popover--top-left {
    --ccs-popover-caret-x: #{$caret-center};
  }

  .#{$prefix}--popover--bottom-right,
  .#{$prefix}--popover--top-right {
    --ccs-popover-caret-x: #{$caret-end};
  }

  .#{$prefix}--popover--right,
  .#{$prefix}--popover--left {
    --ccs-popover-caret-y: 50%;
  }

  .#{$prefix}--popover--right-top,
  .#{$prefix}--popover--left-top {
    --ccs-popover-caret-y: #{$caret-center};
  }

  .#{$prefix}--popover--right-bottom,
  .#{$prefix}--popover--left-bottom {
    --ccs-popover-caret-y: #{$caret-end};
  }

  .#{$prefix}--popover--caret:not(.#{$prefix}--toggletip-popover) {
    --cds-popover-offset: #{to-rem(10px)};
  }

  .#{$prefix}--popover--caret:not(.#{$prefix}--toggletip-popover)
    .#{$prefix}--popover-contents::before,
  .#{$prefix}--popover--caret:not(.#{$prefix}--toggletip-popover)
    .#{$prefix}--popover-contents::after {
    position: absolute;
    top: var(--ccs-popover-caret-y);
    left: var(--ccs-popover-caret-x);
    display: none;
    width: var(--ccs-popover-caret-width);
    height: var(--ccs-popover-caret-height);
    background-color: inherit;
    clip-path: var(--ccs-popover-caret-shape);
    content: "";
    transform: var(--ccs-popover-caret-shift);
  }

  .#{$prefix}--popover--caret:not(.#{$prefix}--toggletip-popover)
    .#{$prefix}--popover-contents::after {
    display: block;
  }

  @include v11-caret-edge(".#{$prefix}--popover--border", $border-subtle);

  // The caret is painted Canvas in forced colors, so it would read as a gap
  // in the surface outline. Draw its edge as for `border`.
  @include high-contrast-mode {
    @include v11-caret-edge("", CanvasText);

    // Forced colors would repaint the `border` edge color Canvas.
    .#{$prefix}--popover--border.#{$prefix}--popover--caret:not(.#{$prefix}--toggletip-popover)
      .#{$prefix}--popover-contents::before {
      background-color: CanvasText;
    }
  }

  // Toggletip, and the AI label callout built on it, keep the v10 caret:
  // two 8px x 8px boxes, one for rendering the box-shadow that the popover
  // content uses and another for layering on top of this box to create an
  // effect of a popover caret with a box-shadow. The layer with the
  // box-shadow is rendered behind the popover content, while the other is
  // rendered above of the popover content. Both partials tune that caret.
  .#{$prefix}--toggletip-popover {
    --cds-popover-offset: #{to-rem(8px)};
  }

  .#{$prefix}--toggletip-popover .#{$prefix}--popover-contents {
    @include box-shadow;
  }

  .#{$prefix}--toggletip-popover .#{$prefix}--popover-contents::before,
  .#{$prefix}--toggletip-popover .#{$prefix}--popover-contents::after {
    position: absolute;
    display: inline-block;
    width: to-rem(8px);
    height: to-rem(8px);
    background-color: inherit;
    content: "";
  }

  .#{$prefix}--toggletip-popover .#{$prefix}--popover-contents::before {
    z-index: -1;
    box-shadow: 2px 2px 6px 0 rgba(0, 0, 0, 0.2);
  }

  @include place-caret(bottom) {
    top: 0;
    left: 50%;
    transform: translate(-50%, -50%) rotate(45deg);
  }

  @include place-caret(bottom-left) {
    top: 0;
    left: 0;
    transform: translate(var(--cds-popover-caret-offset), -50%) rotate(45deg);
  }

  @include place-caret(bottom-right) {
    top: 0;
    right: 0;
    transform: translate(calc(-1 * var(--cds-popover-caret-offset)), -50%)
      rotate(45deg);
  }

  @include place-caret(top) {
    bottom: 0;
    left: 50%;
    transform: translate(-50%, 50%) rotate(45deg);
  }

  @include place-caret(top-left) {
    bottom: 0;
    left: 0;
    transform: translate(var(--cds-popover-caret-offset), 50%) rotate(45deg);
  }

  @include place-caret(top-right) {
    right: 0;
    bottom: 0;
    transform: translate(calc(-1 * var(--cds-popover-caret-offset)), 50%)
      rotate(45deg);
  }

  @include place-caret(right) {
    top: 50%;
    left: 0;
    transform: translate(-50%, -50%) rotate(45deg);
  }

  @include place-caret(right-top) {
    top: 0;
    left: 0;
    transform: translate(-50%, var(--cds-popover-caret-offset)) rotate(45deg);
  }

  @include place-caret(right-bottom) {
    bottom: 0;
    left: 0;
    transform: translate(-50%, calc(-1 * var(--cds-popover-caret-offset)))
      rotate(45deg);
  }

  @include place-caret(left) {
    top: 50%;
    right: 0;
    transform: translate(50%, -50%) rotate(45deg);
  }

  @include place-caret(left-top) {
    top: 0;
    right: 0;
    transform: translate(50%, var(--cds-popover-caret-offset)) rotate(45deg);
  }

  @include place-caret(left-bottom) {
    right: 0;
    bottom: 0;
    transform: translate(50%, calc(-1 * var(--cds-popover-caret-offset)))
      rotate(45deg);
  }

  // The caret is the rotated 8px box layered over the surface. Forced colors
  // paint it Canvas, so it would read as a gap in the surface outline. Edge the
  // two sides that face away from the surface (the apex) with CanvasText. The
  // box stays 8px (border-box), so nothing shifts. The `::before` box only
  // carries the dropped box-shadow and sits behind the surface.
  $caret-edges: (
    "bottom": (top, left),
    "bottom-left": (top, left),
    "bottom-right": (top, left),
    "top": (bottom, right),
    "top-left": (bottom, right),
    "top-right": (bottom, right),
    "right": (bottom, left),
    "right-top": (bottom, left),
    "right-bottom": (bottom, left),
    "left": (top, right),
    "left-top": (top, right),
    "left-bottom": (top, right),
  );

  @include high-contrast-mode {
    @each $direction, $edges in $caret-edges {
      .#{$prefix}--toggletip-popover.#{$prefix}--popover--#{$direction}
        .#{$prefix}--popover-contents::after {
        box-sizing: border-box;
        border: 0 solid CanvasText;

        @each $edge in $edges {
          border-#{$edge}-width: 1px;
        }
      }
    }
  }
}

/// Helper for placing the v10 caret that Toggletip keeps. The selectors here
/// can get distracting in the main stylesheet, but ultimately they target the
/// ::before and ::after pseudo-elements for the given direction. The @content
/// block passed in should appropriately position the caret for the given
/// direction.
/// @access private
/// @group components
@mixin place-caret($direction) {
  .#{$prefix}--toggletip-popover.#{$prefix}--popover--#{$direction}
    .#{$prefix}--popover-contents::before,
  .#{$prefix}--toggletip-popover.#{$prefix}--popover--#{$direction}
    .#{$prefix}--popover-contents::after {
    @content;
  }
}

/// Draws a 1px `$color` edge under the v11 caret: `::before` fills the
/// caret's shape and `::after` moves 1px in and narrows by 1px, so the edge
/// shows along both slopes. `$scope` qualifies the popover (`--border`).
/// @access private
/// @group components
@mixin v11-caret-edge($scope, $color) {
  #{$scope}.#{$prefix}--popover--caret:not(.#{$prefix}--toggletip-popover)
    .#{$prefix}--popover-contents::before {
    display: block;
    background-color: $color;
  }

  #{$scope}.#{$prefix}--popover--caret:not(.#{$prefix}--toggletip-popover)
    .#{$prefix}--popover-contents::after {
    margin: var(--ccs-popover-caret-edge);
    clip-path: var(--ccs-popover-caret-inner);
  }
}

@include exports("popover") {
  @include popover;
}