@wordpress/components
Version:
UI components for WordPress.
185 lines (184 loc) • 8.22 kB
JavaScript
import { useMergeRefs } from "@wordpress/compose";
import { forwardRef, useRef } from "@wordpress/element";
import { InputLayout } from "@wordpress/ui";
import BaseControl from "../base-control/index.mjs";
import { useBaseControlProps } from "../base-control/hooks.mjs";
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/content-editable-control/style.module.scss
if (typeof process === "undefined" || process.env.NODE_ENV !== "test") registerStyle("fed2b5cfb2", "._83648679616c4717__layout{font-size:max(var(--wpds-typography-font-size-md,13px),16px);height:auto;line-height:var(--wpds-typography-line-height-sm,20px);min-height:var(--wpds-dimension-size-lg,40px)}@media (min-width:600px){._83648679616c4717__layout{font-size:var(--wpds-typography-font-size-md,13px)}}._83648679616c4717__layout:focus-within{outline:var(--wpds-border-width-focus,var(--wp-admin-border-width-focus,2px)) solid var(--focus-color,var(--wpds-color-stroke-focus,var(--wp-admin-theme-color,#3858e9)));outline-offset:var(--wpds-border-width-focus,var(--wp-admin-border-width-focus,2px))}._0a7bd9b37b72e74a__editable{flex-grow:1;min-width:0;outline:none;padding-block:calc((var(--wpds-dimension-size-lg, 40px) - var(--wpds-typography-line-height-sm, 20px))/2 - var(--wpds-border-width-xs, 1px));padding-inline:var(--wpds-dimension-padding-md,12px)}._0a7bd9b37b72e74a__editable[aria-placeholder]:empty:before{color:var(--wpds-color-foreground-interactive-neutral-weak,#6e6e6e);content:attr(aria-placeholder)}._0a7bd9b37b72e74a__editable[aria-disabled=true]{cursor:default}._0a7bd9b37b72e74a__editable[aria-disabled=true]:empty:before{color:inherit}");
var style_module_default = {
"layout": "_83648679616c4717__layout",
"editable": "_0a7bd9b37b72e74a__editable"
};
// packages/components/src/content-editable-control/index.tsx
function UnforwardedContentEditableControl({ label, id, className, help, hideLabelFromVision, disabled, required, placeholder, onMouseDown, ...additionalProps }, forwardedRef) {
const { baseControlProps, controlProps } = useBaseControlProps({
id,
className,
help
});
const labelId = `${controlProps.id}__label`;
const editableRef = useRef(null);
const mergedRefs = useMergeRefs([editableRef, forwardedRef]);
return /* @__PURE__ */ jsxs(BaseControl, {
...baseControlProps,
children: [!hideLabelFromVision && /* @__PURE__ */ jsx(BaseControl.VisualLabel, {
id: labelId,
onClick: () => {
if (!disabled) editableRef.current?.focus();
},
children: label
}), /* @__PURE__ */ jsx(InputLayout, {
className: style_module_default.layout,
visuallyDisabled: disabled,
children: /* @__PURE__ */ jsx("div", {
className: style_module_default.editable,
role: "textbox",
"aria-multiline": true,
"aria-label": hideLabelFromVision ? label : void 0,
"aria-labelledby": hideLabelFromVision ? void 0 : labelId,
"aria-placeholder": placeholder || void 0,
"aria-disabled": disabled || void 0,
"aria-required": required || void 0,
ref: mergedRefs,
contentEditable: !disabled,
tabIndex: disabled ? -1 : void 0,
onMouseDown: (event) => {
onMouseDown?.(event);
if (disabled) event.preventDefault();
},
suppressContentEditableWarning: true,
...additionalProps,
...controlProps
})
})]
});
}
/**
* A presentational `contentEditable` form control: a labeled editable element
* rendered with the chrome (`BaseControl` + label) shared by the other form
* controls in the package.
*
* Unlike the in-canvas `RichText` from `@wordpress/block-editor`, this control
* is intended for standalone form fields (DataForms, sidebar inputs, etc.).
* It is deliberately **presentational only** and has no `@wordpress/rich-text`
* dependency: the editable behavior (value, formatting, keyboard shortcuts)
* and any focus/selection tracking are owned by the consumer, which wires them
* through the forwarded ref and native event props (see the richtext DataForm
* control in `@wordpress/dataviews` for the canonical assembly).
*
* ```jsx
* // The rich-text "assembly" lives in the consumer.
* <ContentEditableControl
* label="Caption"
* ref={ mergedRef }
* onFocus={ onEditableFocus }
* onBlur={ onEditableBlur }
* />
* ```
*/
const ContentEditableControl = forwardRef(UnforwardedContentEditableControl);
export { ContentEditableControl, ContentEditableControl as default };
//# sourceMappingURL=index.mjs.map