@wordpress/components
Version:
UI components for WordPress.
1 lines • 16.1 kB
Source Map (JSON)
{"version":3,"file":"index.mjs","names":["styles"],"sources":["../../../style-runtime/src/index.ts","../../src/box-control/style.module.scss","../../src/box-control/index.tsx"],"sourcesContent":["type GlobalScopeWithStyleRuntime = typeof globalThis & {\n\t// This global is shared by separately bundled copies of this package.\n\t// Keep its shape backward compatible after release.\n\t__wpStyleRuntime?: {\n\t\tdocuments: Map< Document, number >;\n\t\tstyles: Map< string, string >;\n\t\tinjectedStyles: WeakMap< Document, Set< string > >;\n\t};\n};\n\nconst STYLE_HASH_ATTRIBUTE = 'data-wp-hash';\n\n/**\n * Returns the shared style runtime registry.\n *\n * The registry is stored on `globalThis` so separately bundled copies of this\n * package can coordinate through the same document and style maps.\n *\n * @return The shared runtime registry.\n */\nfunction getRuntime() {\n\tconst globalScope = globalThis as GlobalScopeWithStyleRuntime;\n\n\tif ( globalScope.__wpStyleRuntime ) {\n\t\treturn globalScope.__wpStyleRuntime;\n\t}\n\n\tglobalScope.__wpStyleRuntime = {\n\t\tdocuments: new Map(),\n\t\tstyles: new Map(),\n\t\tinjectedStyles: new WeakMap(),\n\t};\n\n\tif ( typeof document !== 'undefined' ) {\n\t\tregisterDocument( document );\n\t}\n\n\treturn globalScope.__wpStyleRuntime;\n}\n\n/**\n * Checks whether a document already contains a style tag for a hash.\n *\n * @param targetDocument Document to inspect.\n * @param hash Stable hash for the transformed CSS.\n *\n * @return Whether the style hash already exists in the document.\n */\nfunction documentContainsStyleHash(\n\ttargetDocument: Document,\n\thash: string\n): boolean {\n\tif ( ! targetDocument.head ) {\n\t\treturn false;\n\t}\n\n\tfor ( const style of targetDocument.head.querySelectorAll(\n\t\t`style[${ STYLE_HASH_ATTRIBUTE }]`\n\t) ) {\n\t\tif ( style.getAttribute( STYLE_HASH_ATTRIBUTE ) === hash ) {\n\t\t\treturn true;\n\t\t}\n\t}\n\n\treturn false;\n}\n\n/**\n * Injects a registered style into a document, unless that document already\n * contains a style tag for the same hash.\n *\n * @param targetDocument Document to inject the style into.\n * @param hash Stable hash for the transformed CSS.\n * @param css CSS text to inject.\n */\nfunction injectStyle( targetDocument: Document, hash: string, css: string ) {\n\tif ( ! targetDocument.head ) {\n\t\treturn;\n\t}\n\n\tconst runtime = getRuntime();\n\tlet injectedStyles = runtime.injectedStyles.get( targetDocument );\n\n\tif ( ! injectedStyles ) {\n\t\tinjectedStyles = new Set();\n\t\truntime.injectedStyles.set( targetDocument, injectedStyles );\n\t}\n\n\tif ( injectedStyles.has( hash ) ) {\n\t\treturn;\n\t}\n\n\t// Older generated CSS module output can still inject matching style tags\n\t// after this document's cache is created, so keep the DOM as the fallback\n\t// source of truth on cache misses.\n\tif ( documentContainsStyleHash( targetDocument, hash ) ) {\n\t\tinjectedStyles.add( hash );\n\t\treturn;\n\t}\n\n\tconst style = targetDocument.createElement( 'style' );\n\tstyle.setAttribute( STYLE_HASH_ATTRIBUTE, hash );\n\tstyle.appendChild( targetDocument.createTextNode( css ) );\n\ttargetDocument.head.appendChild( style );\n\tinjectedStyles.add( hash );\n}\n\n/**\n * Registers a document as a style injection target.\n *\n * Existing registered styles are replayed into the document immediately.\n * Documents are reference-counted so multiple providers can safely register the\n * same document without one cleanup removing it while another registration is\n * still active.\n *\n * @param targetDocument Document to receive registered styles.\n * @return Cleanup function that unregisters this document registration.\n */\nexport function registerDocument( targetDocument: Document ) {\n\tconst runtime = getRuntime();\n\n\truntime.documents.set(\n\t\ttargetDocument,\n\t\t( runtime.documents.get( targetDocument ) ?? 0 ) + 1\n\t);\n\n\tfor ( const [ hash, css ] of runtime.styles ) {\n\t\tinjectStyle( targetDocument, hash, css );\n\t}\n\n\treturn () => {\n\t\tconst count = runtime.documents.get( targetDocument );\n\n\t\tif ( count === undefined ) {\n\t\t\treturn;\n\t\t}\n\n\t\tif ( count <= 1 ) {\n\t\t\truntime.documents.delete( targetDocument );\n\t\t\treturn;\n\t\t}\n\n\t\truntime.documents.set( targetDocument, count - 1 );\n\t};\n}\n\n/**\n * Registers a style and injects it into all registered documents.\n *\n * The hash is used as the deduplication key, so calling this repeatedly with\n * the same hash will not add duplicate style tags to a document.\n * Registered styles are retained for the lifetime of the page so they can be\n * replayed into documents that are registered later.\n *\n * @param hash Stable hash for the transformed CSS.\n * @param css CSS text to inject.\n */\nexport function registerStyle( hash: string, css: string ) {\n\tconst runtime = getRuntime();\n\n\truntime.styles.set( hash, css );\n\n\tfor ( const targetDocument of runtime.documents.keys() ) {\n\t\tinjectStyle( targetDocument, hash, css );\n\t}\n}\n","import { registerStyle } from '@wordpress/style-runtime';\nif (typeof process === 'undefined' || process.env.NODE_ENV !== 'test') {\n\tregisterStyle(\"688a11782c\", \".a691e367f1b55f62__unit-control{max-width:90px}._0e04b2962bc33dbb__input-wrapper{grid-column:1/span 3}._2e0e779ca7284bc5__reset-button{grid-area:1/2;justify-self:end}._2feb1869b0c8a32c__linked-button-wrapper{grid-area:1/3;justify-self:end}._3952789640f98f27__icon{flex:0 0 auto}._1155863d57b9789a__range-control{margin-inline-end:8px;width:100%}._2a7a06bc9e98a8bf__icon-root{box-sizing:border-box;display:block;height:24px;padding:4px;position:relative;width:24px}._78a67da593233b1d__icon-viewbox{box-sizing:border-box;display:block;height:100%;position:relative;width:100%}._80edddeeefc17880__icon-stroke{background-color:currentColor;box-sizing:border-box;display:block;opacity:.3;pointer-events:none;position:absolute}.d3e186923be6807c__is-highlighted{opacity:1}._5126d15f8bb86c74__icon-left,.cbbba3ba3bed8033__icon-right{bottom:3px;top:3px;width:2px}._43ffaa6905d27840__icon-bottom,._9543c21b4cb17eaa__icon-top{height:2px;left:3px;right:3px}._9543c21b4cb17eaa__icon-top{top:0}.cbbba3ba3bed8033__icon-right{right:0}._43ffaa6905d27840__icon-bottom{bottom:0}._5126d15f8bb86c74__icon-left{left:0}\");\n}\nexport default {\"unit-control\":\"a691e367f1b55f62__unit-control\",\"input-wrapper\":\"_0e04b2962bc33dbb__input-wrapper\",\"reset-button\":\"_2e0e779ca7284bc5__reset-button\",\"linked-button-wrapper\":\"_2feb1869b0c8a32c__linked-button-wrapper\",\"icon\":\"_3952789640f98f27__icon\",\"range-control\":\"_1155863d57b9789a__range-control\",\"icon-root\":\"_2a7a06bc9e98a8bf__icon-root\",\"icon-viewbox\":\"_78a67da593233b1d__icon-viewbox\",\"icon-stroke\":\"_80edddeeefc17880__icon-stroke\",\"is-highlighted\":\"d3e186923be6807c__is-highlighted\",\"icon-left\":\"_5126d15f8bb86c74__icon-left\",\"icon-right\":\"cbbba3ba3bed8033__icon-right\",\"icon-top\":\"_9543c21b4cb17eaa__icon-top\",\"icon-bottom\":\"_43ffaa6905d27840__icon-bottom\"};\n","import clsx from 'clsx';\nimport { useInstanceId } from '@wordpress/compose';\nimport { useState } from '@wordpress/element';\nimport { __ } from '@wordpress/i18n';\nimport warning from '@wordpress/warning';\nimport { BaseControl } from '../base-control';\nimport BoxInputControl from './box-input-control';\nimport LinkedButton from './linked-button';\nimport Button from '../button';\nimport { Grid } from '../grid';\nimport { HStack } from '../h-stack';\nimport {\n\tDEFAULT_VALUES,\n\tisValueMixed,\n\tisValuesDefined,\n\tgetAllowedSides,\n\tgetSelectedUnits,\n} from './utils';\nimport { useControlledState } from '../utils/hooks';\nimport type { BoxControlProps, BoxControlValue } from './types';\nimport styles from './style.module.scss';\n\nconst defaultInputProps = {\n\tmin: 0,\n};\n\nconst noop = () => {};\n\nfunction useUniqueId( idProp?: string ) {\n\tconst instanceId = useInstanceId( BoxControl, 'inspector-box-control' );\n\n\treturn idProp || instanceId;\n}\n\n/**\n * A control that lets users set values for top, right, bottom, and left. Can be\n * used as an input control for values like `padding` or `margin`.\n *\n * ```jsx\n * import { useState } from 'react';\n * import { BoxControl } from '@wordpress/components';\n *\n * function Example() {\n * const [ values, setValues ] = useState( {\n * top: '50px',\n * left: '10%',\n * right: '10%',\n * bottom: '50px',\n * } );\n *\n * return (\n * <BoxControl values={ values } onChange={ setValues } />\n * );\n * };\n * ```\n */\nfunction BoxControl( {\n\tid: idProp,\n\tinputProps = defaultInputProps,\n\tonChange = noop,\n\tlabel = __( 'Box Control' ),\n\tvalues: valuesProp,\n\tunits,\n\tsides,\n\tsplitOnAxis = false,\n\tallowReset = true,\n\tresetValues = DEFAULT_VALUES,\n\tpresets,\n\tpresetKey,\n\tonMouseOver,\n\tonMouseOut,\n}: BoxControlProps ) {\n\tconst [ values, setValues ] = useControlledState( valuesProp, {\n\t\tfallback: DEFAULT_VALUES,\n\t} );\n\tconst inputValues = values || DEFAULT_VALUES;\n\tconst hasInitialValue = isValuesDefined( valuesProp );\n\tconst hasOneSide = sides?.length === 1;\n\n\tconst [ isDirty, setIsDirty ] = useState( hasInitialValue );\n\tconst [ isLinked, setIsLinked ] = useState(\n\t\t! hasInitialValue || ! isValueMixed( inputValues ) || hasOneSide\n\t);\n\n\t// Tracking selected units via internal state allows filtering of CSS unit\n\t// only values from being saved while maintaining preexisting unit selection\n\t// behaviour. Filtering CSS only values prevents invalid style values.\n\tconst [ selectedUnits, setSelectedUnits ] = useState< BoxControlValue >(\n\t\tgetSelectedUnits( valuesProp )\n\t);\n\n\tconst id = useUniqueId( idProp );\n\tconst headingId = `${ id }-heading`;\n\n\tconst toggleLinked = () => {\n\t\tsetIsLinked( ! isLinked );\n\t};\n\n\tconst handleOnChange = ( nextValues: BoxControlValue ) => {\n\t\tonChange( nextValues );\n\t\tsetValues( nextValues );\n\t\tsetIsDirty( true );\n\t};\n\n\tconst handleOnReset = () => {\n\t\tonChange( resetValues );\n\t\tsetValues( resetValues );\n\t\tsetSelectedUnits( getSelectedUnits( resetValues ) );\n\t\tsetIsDirty( false );\n\t};\n\n\tconst inputControlProps = {\n\t\tonMouseOver,\n\t\tonMouseOut,\n\t\t...inputProps,\n\t\tonChange: handleOnChange,\n\t\tisLinked,\n\t\tunits,\n\t\tselectedUnits,\n\t\tsetSelectedUnits,\n\t\tsides,\n\t\tvalues: inputValues,\n\t\tpresets,\n\t\tpresetKey,\n\t};\n\n\tconst sidesToRender = getAllowedSides( sides );\n\n\tif ( ( presets && ! presetKey ) || ( ! presets && presetKey ) ) {\n\t\tconst definedProp = presets ? 'presets' : 'presetKey';\n\t\tconst missingProp = presets ? 'presetKey' : 'presets';\n\t\twarning(\n\t\t\t`wp.components.BoxControl: the '${ missingProp }' prop is required when the '${ definedProp }' prop is defined.`\n\t\t);\n\t}\n\n\treturn (\n\t\t<Grid\n\t\t\tid={ id }\n\t\t\tcolumns={ 3 }\n\t\t\ttemplateColumns=\"1fr min-content min-content\"\n\t\t\trole=\"group\"\n\t\t\taria-labelledby={ headingId }\n\t\t>\n\t\t\t<BaseControl.VisualLabel id={ headingId }>\n\t\t\t\t{ label }\n\t\t\t</BaseControl.VisualLabel>\n\t\t\t{ isLinked && (\n\t\t\t\t<HStack className={ styles[ 'input-wrapper' ] }>\n\t\t\t\t\t<BoxInputControl side=\"all\" { ...inputControlProps } />\n\t\t\t\t</HStack>\n\t\t\t) }\n\t\t\t{ ! hasOneSide && (\n\t\t\t\t<div className={ styles[ 'linked-button-wrapper' ] }>\n\t\t\t\t\t<LinkedButton\n\t\t\t\t\t\tonClick={ toggleLinked }\n\t\t\t\t\t\tisLinked={ isLinked }\n\t\t\t\t\t/>\n\t\t\t\t</div>\n\t\t\t) }\n\n\t\t\t{ ! isLinked &&\n\t\t\t\tsplitOnAxis &&\n\t\t\t\t[ 'vertical', 'horizontal' ].map( ( axis ) => (\n\t\t\t\t\t<BoxInputControl\n\t\t\t\t\t\tkey={ axis }\n\t\t\t\t\t\tside={ axis as 'horizontal' | 'vertical' }\n\t\t\t\t\t\t{ ...inputControlProps }\n\t\t\t\t\t/>\n\t\t\t\t) ) }\n\t\t\t{ ! isLinked &&\n\t\t\t\t! splitOnAxis &&\n\t\t\t\tArray.from( sidesToRender ).map( ( axis ) => (\n\t\t\t\t\t<BoxInputControl\n\t\t\t\t\t\tkey={ axis }\n\t\t\t\t\t\tside={ axis }\n\t\t\t\t\t\t{ ...inputControlProps }\n\t\t\t\t\t/>\n\t\t\t\t) ) }\n\t\t\t{ allowReset && (\n\t\t\t\t<Button\n\t\t\t\t\tclassName={ clsx(\n\t\t\t\t\t\tstyles[ 'reset-button' ],\n\t\t\t\t\t\t'component-box-control__reset-button'\n\t\t\t\t\t) }\n\t\t\t\t\tvariant=\"secondary\"\n\t\t\t\t\tsize=\"small\"\n\t\t\t\t\tonClick={ handleOnReset }\n\t\t\t\t\tdisabled={ ! isDirty }\n\t\t\t\t\taccessibleWhenDisabled\n\t\t\t\t>\n\t\t\t\t\t{ __( 'Reset' ) }\n\t\t\t\t</Button>\n\t\t\t) }\n\t\t</Grid>\n\t);\n}\n\nexport default BoxControl;\n"],"mappings":"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"}