Allow Overlay above SlidePanel

Issue Description

CareAware Connect would like to use LoadingOverlay above all parts of SlidePanel, including the panel part. This is currently not possible without manually overriding the z-index of the overlay.

This is because Overlay has a z-index of 100 and SlidePanel’s panel has a z-index of 500.

I’d like to propose introducing a prop to dictate whether Overlay has a larger z-index. Considerations will need to be made for whether Overlay covers modals in this scenario.

Issue Type

• New Feature
• Enhancement
• Bug
• Other

Expected Behavior

Overlay covers both single and multi-panel SlidePanel mode

Current Behavior

Overlay is hidden in single slide panel mode

Steps to Reproduce

N/A

Environment

• Component Version:
• Browser Name and Version: Chrome 61.0.3163.100 (Official Build) (64-bit)
• Operating System and version (desktop or mobile): macOS 10.12.6 (16G29)

[neilpfeiffer]

Discussed with @dkasper-was-taken as to technical issues. If a overlay is presented from a SlidePanel, or any container with it’s position set by transform, the fullscreen overlay does not work as intended (loses context of original document positioning).

As a generally concept, we probably want to avoid opening up the option to add zIndex as prop and leave up to consumers without a central governing strategy, which would create an accidental and uncontrolled “king-of-the-hill” situation when multiple higher-order components are combined onto one page or within one application.

Possible option that solves for both concerns is to add a new type of fullscreen overlay that is portaled and at a z-index of 9999 or similar. For current passivity, we could keep the isRelativeToContainer prop since it is widely used (eventually deprecate & remove), and introduce a new prop, something like relativeTo: container, fullscreen, portal (final names pending) keeping the first two as-is with current behavior and z-index and introducing the third type as new (portaled version will be similar to AbstractModal).

[bjankord]

@neilpfeiffer Any thoughts on making the overlay always appear over everything.