@primer/react
Version:
An implementation of GitHub's Primer Design System using React
170 lines (164 loc) • 8.17 kB
JavaScript
import styled from 'styled-components';
import React__default, { useRef, useEffect } from 'react';
import useIsomorphicLayoutEffect from '../utils/useIsomorphicLayoutEffect.js';
import { get } from '../constants.js';
import { Portal } from '../Portal/Portal.js';
import sx from '../sx.js';
import { useRefObjectAsForwardedRef } from '../hooks/useRefObjectAsForwardedRef.js';
import { useTheme } from '../ThemeProvider.js';
import { useOverlay } from '../hooks/useOverlay.js';
function _extends() { _extends = Object.assign ? Object.assign.bind() : function (target) { for (var i = 1; i < arguments.length; i++) { var source = arguments[i]; for (var key in source) { if (Object.prototype.hasOwnProperty.call(source, key)) { target[key] = source[key]; } } } return target; }; return _extends.apply(this, arguments); }
const heightMap = {
xsmall: '192px',
small: '256px',
medium: '320px',
large: '432px',
xlarge: '600px',
auto: 'auto',
initial: 'auto' // Passing 'initial' initially applies 'auto'
};
const widthMap = {
small: '256px',
medium: '320px',
large: '480px',
xlarge: '640px',
xxlarge: '960px',
auto: 'auto'
};
const animationDuration = 200;
function getSlideAnimationStartingVector(anchorSide) {
if (anchorSide !== null && anchorSide !== void 0 && anchorSide.endsWith('bottom')) {
return {
x: 0,
y: -1
};
} else if (anchorSide !== null && anchorSide !== void 0 && anchorSide.endsWith('top')) {
return {
x: 0,
y: 1
};
} else if (anchorSide !== null && anchorSide !== void 0 && anchorSide.endsWith('right')) {
return {
x: -1,
y: 0
};
} else if (anchorSide !== null && anchorSide !== void 0 && anchorSide.endsWith('left')) {
return {
x: 1,
y: 0
};
}
return {
x: 0,
y: 0
};
}
const StyledOverlay = styled.div.withConfig({
displayName: "Overlay__StyledOverlay",
componentId: "sc-51280t-0"
})(["background-color:", ";box-shadow:", ";position:absolute;min-width:192px;max-width:640px;height:", ";max-height:", ";width:", ";border-radius:12px;overflow:hidden;animation:overlay-appear ", "ms ", ";@keyframes overlay-appear{0%{opacity:0;}100%{opacity:1;}}visibility:var(--styled-overlay-visibility);:focus{outline:none;}@media (forced-colors:active){outline:solid 1px transparent;}", ";"], get('colors.canvas.overlay'), get('shadows.overlay.shadow'), props => heightMap[props.height || 'auto'], props => props.maxHeight && heightMap[props.maxHeight], props => widthMap[props.width || 'auto'], animationDuration, get('animation.easeOutCubic'), sx);
/**
* An `Overlay` is a flexible floating surface, used to display transient content such as menus,
* selection options, dialogs, and more. Overlays use shadows to express elevation. The `Overlay`
* component handles all behaviors needed by overlay UIs as well as the common styles that all overlays * should have.
* @param ignoreClickRefs Optional. An array of ref objects to ignore clicks on in the `onOutsideClick` behavior. This is often used to ignore clicking on the element that toggles the open/closed state for the `Overlay` to prevent the `Overlay` from being toggled twice.
* @param initialFocusRef Optional. Ref for the element to focus when the `Overlay` is opened. If nothing is provided, the first focusable element in the `Overlay` body is focused.
* @param returnFocusRef Required. Ref for the element to focus when the `Overlay` is closed.
* @param onClickOutside Required. Function to call when clicking outside of the `Overlay`. Typically this function removes the Overlay.
* @param onEscape Required. Function to call when user presses `Escape`. Typically this function removes the Overlay.
* @param width Sets the width of the `Overlay`, pick from our set list of widths, or pass `auto` to automatically set the width based on the content of the `Overlay`. `small` corresponds to `256px`, `medium` corresponds to `320px`, `large` corresponds to `480px`, `xlarge` corresponds to `640px`, `xxlarge` corresponds to `960px`.
* @param height Sets the height of the `Overlay`, pick from our set list of heights, or pass `auto` to automatically set the height based on the content of the `Overlay`, or pass `initial` to set the height based on the initial content of the `Overlay` (i.e. ignoring content changes). `xsmall` corresponds to `192px`, `small` corresponds to `256px`, `medium` corresponds to `320px`, `large` corresponds to `432px`, `xlarge` corresponds to `600px`.
* @param maxHeight Sets the maximum height of the `Overlay`, pick from our set list of heights. `xsmall` corresponds to `192px`, `small` corresponds to `256px`, `medium` corresponds to `320px`, `large` corresponds to `432px`, `xlarge` corresponds to `600px`.
* @param anchorSide If provided, the Overlay will slide into position from the side of the anchor with a brief animation
* @param top Optional. Vertical top position of the overlay, relative to its closest positioned ancestor (often its `Portal`).
* @param left Optional. Horizontal left position of the overlay, relative to its closest positioned ancestor (often its `Portal`).
* @param right Optional. Horizontal right position of the overlay, relative to its closest positioned ancestor (often its `Portal`).
* @param bottom Optional. Vertical bottom position of the overlay, relative to its closest positioned ancestor (often its `Portal`).
* @param position Optional. Sets how an element is positioned in a document. Defaults to `absolute` positioning.
* @param portalContainerName Optional. The name of the portal container to render the Overlay into.
*/
const Overlay = /*#__PURE__*/React__default.forwardRef(({
onClickOutside,
role = 'none',
initialFocusRef,
returnFocusRef,
ignoreClickRefs,
onEscape,
visibility = 'visible',
height = 'auto',
width = 'auto',
top,
left,
right,
bottom,
anchorSide,
portalContainerName,
preventFocusOnOpen,
position,
...rest
}, forwardedRef) => {
const overlayRef = useRef(null);
useRefObjectAsForwardedRef(forwardedRef, overlayRef);
const {
theme
} = useTheme();
const slideAnimationDistance = parseInt(get('space.2')(theme).replace('px', ''));
const slideAnimationEasing = get('animation.easeOutCubic')(theme);
useOverlay({
overlayRef,
returnFocusRef,
onEscape,
ignoreClickRefs,
onClickOutside,
initialFocusRef,
preventFocusOnOpen
});
useEffect(() => {
var _overlayRef$current;
if (height === 'initial' && (_overlayRef$current = overlayRef.current) !== null && _overlayRef$current !== void 0 && _overlayRef$current.clientHeight) {
overlayRef.current.style.height = `${overlayRef.current.clientHeight}px`;
}
}, [height]);
useIsomorphicLayoutEffect(() => {
var _overlayRef$current2;
const {
x,
y
} = getSlideAnimationStartingVector(anchorSide);
if (!x && !y || !((_overlayRef$current2 = overlayRef.current) !== null && _overlayRef$current2 !== void 0 && _overlayRef$current2.animate) || visibility === 'hidden') {
return;
}
// JS animation is required because Safari does not allow css animations to start paused and then run
overlayRef.current.animate({
transform: [`translate(${slideAnimationDistance * x}px, ${slideAnimationDistance * y}px)`, `translate(0, 0)`]
}, {
duration: animationDuration,
easing: slideAnimationEasing
});
}, [anchorSide, slideAnimationDistance, slideAnimationEasing, visibility]);
// To be backwards compatible with the old Overlay, we need to set the left prop if x-position is not specified
const leftPosition = left === undefined && right === undefined ? {
left: 0
} : {
left
};
return /*#__PURE__*/React__default.createElement(Portal, {
containerName: portalContainerName
}, /*#__PURE__*/React__default.createElement(StyledOverlay, _extends({
height: height,
width: width,
role: role
}, rest, {
ref: overlayRef,
style: {
...leftPosition,
right,
top,
bottom,
position,
'--styled-overlay-visibility': visibility
}
})));
});
var Overlay$1 = Overlay;
export { Overlay$1 as default };