@wordpress/components
Version:
UI components for WordPress.
162 lines (161 loc) • 7.13 kB
JavaScript
import clsx from "clsx";
import { __ } from "@wordpress/i18n";
import { forwardRef } from "@wordpress/element";
import deprecated from "@wordpress/deprecated";
import { jsx, jsxs } 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/progress-bar/style.module.scss
if (typeof process === "undefined" || process.env.NODE_ENV !== "test") registerStyle("b750609651", "._302459c1e4ecf4c0__track{background-color:var(--wpds-color-background-track-neutral,#dbdbdb);border-radius:9999px;height:1.5px;outline:2px solid transparent;outline-offset:2px;overflow:hidden;position:relative}:where(._302459c1e4ecf4c0__track){width:160px}._371656c30c80866d__indicator{background-color:var(--wpds-color-background-indicator-neutral,#1e1e1e);border-radius:9999px;display:inline-block;height:100%;outline:2px solid transparent;outline-offset:-2px;position:absolute;top:0;width:var(--indicator-width)}@media not (prefers-reduced-motion){._371656c30c80866d__indicator{transition:width .4s ease-in-out}}._371656c30c80866d__indicator.c8c112f0c2c410c8__is-indeterminate{--indicator-width:50%;animation:_452b51221f502706__indeterminate-slide 1.5s ease-in-out infinite;transition:none}@media (prefers-reduced-motion:reduce){._371656c30c80866d__indicator.c8c112f0c2c410c8__is-indeterminate{animation-duration:3s;animation-timing-function:steps(4)}}@keyframes _452b51221f502706__indeterminate-slide{0%{inset-inline-start:-50%}to{inset-inline-start:100%}}._42829dd460673be7__progress-element{height:100%;inset-inline-start:0;opacity:0;position:absolute;top:0;width:100%}");
var style_module_default = {
"track": "_302459c1e4ecf4c0__track",
"indicator": "_371656c30c80866d__indicator",
"is-indeterminate": "c8c112f0c2c410c8__is-indeterminate",
"indeterminate-slide": "_452b51221f502706__indeterminate-slide",
"progress-element": "_42829dd460673be7__progress-element"
};
// packages/components/src/progress-bar/index.tsx
function UnforwardedProgressBar(props, ref) {
deprecated("wp.components.ProgressBar", {
since: "7.3",
version: "7.5",
alternative: "Progress from @wordpress/ui"
});
const { className, value, ...progressProps } = props;
const isIndeterminate = !Number.isFinite(value);
return /* @__PURE__ */ jsxs("div", {
className: clsx(style_module_default.track, className),
children: [/* @__PURE__ */ jsx("div", {
className: clsx(style_module_default.indicator, { [style_module_default["is-indeterminate"]]: isIndeterminate }),
style: { "--indicator-width": !isIndeterminate ? `${value}%` : void 0 }
}), /* @__PURE__ */ jsx("progress", {
className: style_module_default["progress-element"],
max: 100,
value,
"aria-label": __("Loading…"),
ref,
...progressProps
})]
});
}
/**
* A simple horizontal progress bar component.
*
* Supports two modes: determinate and indeterminate. A progress bar is determinate
* when a specific progress value has been specified (from 0 to 100), and indeterminate
* when a value hasn't been specified.
*
* @deprecated Use `Progress` from `@wordpress/ui` instead.
*
* ```jsx
* import { ProgressBar } from '@wordpress/components';
*
* const MyLoadingComponent = () => {
* return <ProgressBar />;
* };
* ```
*/
const ProgressBar = forwardRef(UnforwardedProgressBar);
ProgressBar.displayName = "ProgressBar";
export { ProgressBar, ProgressBar as default };
//# sourceMappingURL=index.mjs.map