@wordpress/components
Version:
UI components for WordPress.
193 lines (192 loc) • 9.35 kB
JavaScript
import clsx from "clsx";
import { focus } from "@wordpress/dom";
import { useContext, useEffect, useId, useRef } from "@wordpress/element";
import { useMergeRefs } from "@wordpress/compose";
import { escapeAttribute } from "@wordpress/escape-html";
import warning from "@wordpress/warning";
import { contextConnect, useContextSystem } from "../../context/index.mjs";
import { View } from "../../view/index.mjs";
import { NavigatorContext } from "../context.mjs";
import { useScreenAnimatePresence } from "./use-screen-animate-presence.mjs";
import { jsx } from "react/jsx-runtime";
// packages/style-runtime/src/index.ts
const STYLE_HASH_ATTRIBUTE = "data-wp-hash";
/**
* Returns the shared style runtime registry.
*
* The registry is stored on `globalThis` so separately bundled copies of this
* package can coordinate through the same document and style maps.
*
* @return The shared runtime registry.
*/
function getRuntime() {
const globalScope = globalThis;
if (globalScope.__wpStyleRuntime) return globalScope.__wpStyleRuntime;
globalScope.__wpStyleRuntime = {
documents: /* @__PURE__ */ new Map(),
styles: /* @__PURE__ */ new Map(),
injectedStyles: /* @__PURE__ */ new WeakMap()
};
if (typeof document !== "undefined") registerDocument(document);
return globalScope.__wpStyleRuntime;
}
/**
* Checks whether a document already contains a style tag for a hash.
*
* @param targetDocument Document to inspect.
* @param hash Stable hash for the transformed CSS.
*
* @return Whether the style hash already exists in the document.
*/
function documentContainsStyleHash(targetDocument, hash) {
if (!targetDocument.head) return false;
for (const style of targetDocument.head.querySelectorAll(`style[${STYLE_HASH_ATTRIBUTE}]`)) if (style.getAttribute(STYLE_HASH_ATTRIBUTE) === hash) return true;
return false;
}
/**
* Injects a registered style into a document, unless that document already
* contains a style tag for the same hash.
*
* @param targetDocument Document to inject the style into.
* @param hash Stable hash for the transformed CSS.
* @param css CSS text to inject.
*/
function injectStyle(targetDocument, hash, css) {
if (!targetDocument.head) return;
const runtime = getRuntime();
let injectedStyles = runtime.injectedStyles.get(targetDocument);
if (!injectedStyles) {
injectedStyles = /* @__PURE__ */ new Set();
runtime.injectedStyles.set(targetDocument, injectedStyles);
}
if (injectedStyles.has(hash)) return;
if (documentContainsStyleHash(targetDocument, hash)) {
injectedStyles.add(hash);
return;
}
const style = targetDocument.createElement("style");
style.setAttribute(STYLE_HASH_ATTRIBUTE, hash);
style.appendChild(targetDocument.createTextNode(css));
targetDocument.head.appendChild(style);
injectedStyles.add(hash);
}
/**
* Registers a document as a style injection target.
*
* Existing registered styles are replayed into the document immediately.
* Documents are reference-counted so multiple providers can safely register the
* same document without one cleanup removing it while another registration is
* still active.
*
* @param targetDocument Document to receive registered styles.
* @return Cleanup function that unregisters this document registration.
*/
function registerDocument(targetDocument) {
const runtime = getRuntime();
runtime.documents.set(targetDocument, (runtime.documents.get(targetDocument) ?? 0) + 1);
for (const [hash, css] of runtime.styles) injectStyle(targetDocument, hash, css);
return () => {
const count = runtime.documents.get(targetDocument);
if (count === void 0) return;
if (count <= 1) {
runtime.documents.delete(targetDocument);
return;
}
runtime.documents.set(targetDocument, count - 1);
};
}
/**
* Registers a style and injects it into all registered documents.
*
* The hash is used as the deduplication key, so calling this repeatedly with
* the same hash will not add duplicate style tags to a document.
* Registered styles are retained for the lifetime of the page so they can be
* replayed into documents that are registered later.
*
* @param hash Stable hash for the transformed CSS.
* @param css CSS text to inject.
*/
function registerStyle(hash, css) {
const runtime = getRuntime();
runtime.styles.set(hash, css);
for (const targetDocument of runtime.documents.keys()) injectStyle(targetDocument, hash, css);
}
// packages/components/src/navigator/style.module.scss
if (typeof process === "undefined" || process.env.NODE_ENV !== "test") registerStyle("b30a5e7ac2", "._1806275ce8929e7d__wrapper{align-items:start;contain:layout;display:grid;grid-template-columns:1fr;grid-template-rows:1fr;overflow-x:clip;position:relative}._4c65901274886a7f__screen{box-sizing:border-box;grid-column:1/-1;grid-row:1/-1;max-height:100%;overflow-x:auto;position:relative}@keyframes _6d09f2ceaa9297af__fade-in{0%{opacity:0}}@keyframes _54a2b781a80e54b0__fade-out{to{opacity:0}}@keyframes _01f0a447f9a87260__slide-from-right{0%{transform:translateX(100px)}}@keyframes _378d3b594da59a81__slide-to-left{to{transform:translateX(-80px)}}@keyframes _1ff6b948a98cfba4__slide-from-left{0%{transform:translateX(-100px)}}@keyframes b58ded70195ed586__slide-to-right{to{transform:translateX(80px)}}.eda03f92d0135c15__screen-animation{z-index:1}.eda03f92d0135c15__screen-animation[data-animation-type=out]{z-index:0}@media not (prefers-reduced-motion){.eda03f92d0135c15__screen-animation:not([data-skip-animation])[data-animation-direction=end][data-animation-type=in]{animation:_6d09f2ceaa9297af__fade-in 70ms linear 70ms both,_01f0a447f9a87260__slide-from-right .3s cubic-bezier(.33,0,0,1) both}.eda03f92d0135c15__screen-animation:not([data-skip-animation])[data-animation-direction=end][data-animation-type=out]{animation:_54a2b781a80e54b0__fade-out 70ms linear 40ms both,_378d3b594da59a81__slide-to-left .3s cubic-bezier(.33,0,0,1) both}.eda03f92d0135c15__screen-animation:not([data-skip-animation])[data-animation-direction=start][data-animation-type=in]{animation:_6d09f2ceaa9297af__fade-in 70ms linear 70ms both,_1ff6b948a98cfba4__slide-from-left .3s cubic-bezier(.33,0,0,1) both}.eda03f92d0135c15__screen-animation:not([data-skip-animation])[data-animation-direction=start][data-animation-type=out]{animation:_54a2b781a80e54b0__fade-out 70ms linear 40ms both,b58ded70195ed586__slide-to-right .3s cubic-bezier(.33,0,0,1) both}}");
var style_module_default = {
"wrapper": "_1806275ce8929e7d__wrapper",
"screen": "_4c65901274886a7f__screen",
"screen-animation": "eda03f92d0135c15__screen-animation",
"fade-in": "_6d09f2ceaa9297af__fade-in",
"slide-from-right": "_01f0a447f9a87260__slide-from-right",
"fade-out": "_54a2b781a80e54b0__fade-out",
"slide-to-left": "_378d3b594da59a81__slide-to-left",
"slide-from-left": "_1ff6b948a98cfba4__slide-from-left",
"slide-to-right": "b58ded70195ed586__slide-to-right"
};
// packages/components/src/navigator/navigator-screen/component.tsx
function UnconnectedNavigatorScreen(props, forwardedRef) {
if (!/^\//.test(props.path)) warning("wp.components.Navigator.Screen: the `path` should follow a URL-like scheme; it should start with and be separated by the `/` character.");
const screenId = useId();
const { children, className, path, onAnimationEnd: onAnimationEndProp, ...otherProps } = useContextSystem(props, "Navigator.Screen");
const { location, match, addScreen, removeScreen } = useContext(NavigatorContext);
const { isInitial, isBack, focusTargetSelector, skipFocus } = location;
const isMatch = match === screenId;
const wrapperRef = useRef(null);
const skipAnimationAndFocusRestoration = !!isInitial && !isBack;
useEffect(() => {
const screen = {
id: screenId,
path: escapeAttribute(path)
};
addScreen(screen);
return () => removeScreen(screen);
}, [
screenId,
path,
addScreen,
removeScreen
]);
const { shouldRenderScreen, screenProps } = useScreenAnimatePresence({
isMatch,
isBack,
onAnimationEnd: onAnimationEndProp,
skipAnimation: skipAnimationAndFocusRestoration
});
const classes = clsx(style_module_default.screen, style_module_default["screen-animation"], className);
const locationRef = useRef(location);
useEffect(() => {
locationRef.current = location;
}, [location]);
useEffect(() => {
const wrapperEl = wrapperRef.current;
if (skipAnimationAndFocusRestoration || !isMatch || !wrapperEl || locationRef.current.hasRestoredFocus || skipFocus) return;
const activeElement = wrapperEl.ownerDocument.activeElement;
if (wrapperEl.contains(activeElement)) return;
let elementToFocus = null;
if (isBack && focusTargetSelector) elementToFocus = wrapperEl.querySelector(focusTargetSelector);
if (!elementToFocus) {
const [firstTabbable] = focus.tabbable.find(wrapperEl);
elementToFocus = firstTabbable ?? wrapperEl;
}
locationRef.current.hasRestoredFocus = true;
elementToFocus.focus();
}, [
skipAnimationAndFocusRestoration,
isMatch,
isBack,
focusTargetSelector,
skipFocus
]);
const mergedWrapperRef = useMergeRefs([forwardedRef, wrapperRef]);
return shouldRenderScreen ? /* @__PURE__ */ jsx(View, {
ref: mergedWrapperRef,
className: classes,
...screenProps,
...otherProps,
children
}) : null;
}
const NavigatorScreen = contextConnect(UnconnectedNavigatorScreen, "Navigator.Screen");
export { NavigatorScreen };
//# sourceMappingURL=component.mjs.map