UNPKG

@wordpress/components

Version:
171 lines (170 loc) • 6.58 kB
import clsx from "clsx"; import deprecated from "@wordpress/deprecated"; import { isValidElement } from "@wordpress/element"; import { getValidChildren } from "../utils/get-valid-children.mjs"; import { contextConnect, useContextSystem } from "../context/index.mjs"; import { PolymorphicElement } from "../utils/polymorphic-element.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/z-stack/style.module.scss if (typeof process === "undefined" || process.env.NODE_ENV !== "test") registerStyle("5e02a316c4", "._19fd7e8b6ff0a5b0__z-stack{display:inline-grid;grid-auto-flow:column;position:relative}._19fd7e8b6ff0a5b0__z-stack>._91aa8c6c7adc88b5__child{justify-self:start;position:relative}.f5be843de6879326__layered>._91aa8c6c7adc88b5__child{grid-column-start:1;grid-row-start:1}._91aa8c6c7adc88b5__child{z-index:var(--z-stack-z-index,auto)}._91aa8c6c7adc88b5__child:not(:first-of-type){margin-inline-start:var(--z-stack-offset,0)}"); var style_module_default = { "z-stack": "_19fd7e8b6ff0a5b0__z-stack", "child": "_91aa8c6c7adc88b5__child", "layered": "f5be843de6879326__layered" }; // packages/components/src/z-stack/component.tsx function UnconnectedZStack(props, forwardedRef) { deprecated("wp.components.__experimentalZStack", { since: "7.2", version: "7.4", alternative: "your own CSS" }); const { children, className, isLayered = true, isReversed = false, offset = 0, ...otherProps } = useContextSystem(props, "ZStack"); const validChildren = getValidChildren(children); const childrenLastIndex = validChildren.length - 1; const clonedChildren = validChildren.map((child, index) => { const zIndex = isReversed ? childrenLastIndex - index : index; const offsetAmount = isLayered ? offset * index : offset; const key = isValidElement(child) ? child.key : index; return /* @__PURE__ */ jsx("div", { className: style_module_default.child, style: { "--z-stack-offset": `${offsetAmount}px`, "--z-stack-z-index": zIndex }, children: child }, key); }); return /* @__PURE__ */ jsx(PolymorphicElement, { ...otherProps, className: clsx(style_module_default["z-stack"], isLayered && style_module_default.layered, className), ref: forwardedRef, children: clonedChildren }); } /** * `ZStack` allows you to stack things along the Z-axis. * * This component is deprecated. Write your own CSS instead. * * @deprecated * * ```jsx * import { __experimentalZStack as ZStack } from '@wordpress/components'; * * function Example() { * return ( * <ZStack offset={ 20 } isLayered> * <ExampleImage /> * <ExampleImage /> * <ExampleImage /> * </ZStack> * ); * } * ``` */ const ZStack = contextConnect(UnconnectedZStack, "ZStack"); export { ZStack, ZStack as default }; //# sourceMappingURL=component.mjs.map