UNPKG

@wordpress/components

Version:
185 lines (184 loc) • 8.22 kB
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