@wordpress/block-editor
Version:
8 lines (7 loc) • 7.11 kB
Source Map (JSON)
{
"version": 3,
"sources": ["../../../src/components/dimension-control/index.js"],
"sourcesContent": ["/**\n * WordPress dependencies\n */\nimport { useMemo, useState } from '@wordpress/element';\nimport {\n\tBaseControl,\n\t__experimentalParseQuantityAndUnitFromRawValue as parseQuantityAndUnitFromRawValue,\n\t__experimentalUseCustomUnits as useCustomUnits,\n} from '@wordpress/components';\nimport { __ } from '@wordpress/i18n';\n\n/**\n * Internal dependencies\n */\nimport { useSettings } from '../use-settings';\nimport PresetInputControl from '../preset-input-control';\nimport { CUSTOM_VALUE_SETTINGS } from '../preset-input-control/constants';\n\nconst EMPTY_ARRAY = [];\n\n// Dimension-specific custom value settings - override defaults for larger dimension values\nconst DIMENSION_CUSTOM_VALUE_SETTINGS = {\n\t...CUSTOM_VALUE_SETTINGS,\n\tpx: { max: 1000, steps: 1 },\n\tem: { max: 50, steps: 0.1 },\n\trem: { max: 50, steps: 0.1 },\n};\n\n/**\n * Hook to retrieve dimension sizes from theme settings.\n *\n * @param {Object} presets Dimension presets object containing default, theme, and custom sizes.\n * @return {Array} Array of dimension size options.\n */\nfunction useDimensionSizes( presets ) {\n\tconst defaultSizes = presets?.default ?? EMPTY_ARRAY;\n\tconst customSizes = presets?.custom ?? EMPTY_ARRAY;\n\tconst themeSizes = presets?.theme ?? EMPTY_ARRAY;\n\n\treturn useMemo( () => {\n\t\tconst sizes = [\n\t\t\t{ name: __( 'None' ), slug: '0', size: 0 },\n\t\t\t...customSizes,\n\t\t\t...themeSizes,\n\t\t\t...defaultSizes,\n\t\t];\n\n\t\treturn sizes;\n\t}, [ customSizes, themeSizes, defaultSizes ] );\n}\n\n/**\n * DimensionControl renders a linked unit control and range control for adjusting dimensions of a block.\n *\n * @see https://github.com/WordPress/gutenberg/blob/HEAD/packages/block-editor/src/components/dimension-control/README.md\n *\n * @param {Object} props\n * @param {?string} props.label A label for the control.\n * @param {( value: string ) => void } props.onChange Called when the dimension value changes.\n * @param {string} props.value The current dimension value.\n *\n * @return {Component} The component to be rendered.\n */\nexport default function DimensionControl( {\n\tlabel = __( 'Dimension' ),\n\tonChange,\n\tvalue,\n} ) {\n\tconst [ dimensionSizes, availableUnits ] = useSettings(\n\t\t'dimensions.dimensionSizes',\n\t\t'spacing.units'\n\t);\n\n\tconst units = useCustomUnits( {\n\t\tavailableUnits: availableUnits || [\n\t\t\t'%',\n\t\t\t'px',\n\t\t\t'em',\n\t\t\t'rem',\n\t\t\t'vh',\n\t\t\t'vw',\n\t\t],\n\t} );\n\n\tconst options = useDimensionSizes( dimensionSizes );\n\n\t// Track selected unit for PresetInputControl\n\tconst [ selectedUnit, setSelectedUnit ] = useState( () => {\n\t\tconst [ , unit ] = parseQuantityAndUnitFromRawValue( value );\n\t\treturn unit || units[ 0 ]?.value || 'px';\n\t} );\n\n\tconst handleUnitChange = ( newUnit ) => {\n\t\t// Attempt to smooth over differences between currentUnit and newUnit.\n\t\t// This should slightly improve the experience of switching between unit types.\n\t\tconst [ currentValue, currentUnit ] =\n\t\t\tparseQuantityAndUnitFromRawValue( value );\n\n\t\tif ( [ 'em', 'rem' ].includes( newUnit ) && currentUnit === 'px' ) {\n\t\t\t// Convert pixel value to an approximate of the new unit, assuming a root size of 16px.\n\t\t\tonChange( ( currentValue / 16 ).toFixed( 2 ) + newUnit );\n\t\t} else if (\n\t\t\t[ 'em', 'rem' ].includes( currentUnit ) &&\n\t\t\tnewUnit === 'px'\n\t\t) {\n\t\t\t// Convert to pixel value assuming a root size of 16px.\n\t\t\tonChange( Math.round( currentValue * 16 ) + newUnit );\n\t\t} else if (\n\t\t\t[\n\t\t\t\t'%',\n\t\t\t\t'vw',\n\t\t\t\t'svw',\n\t\t\t\t'lvw',\n\t\t\t\t'dvw',\n\t\t\t\t'vh',\n\t\t\t\t'svh',\n\t\t\t\t'lvh',\n\t\t\t\t'dvh',\n\t\t\t\t'vi',\n\t\t\t\t'svi',\n\t\t\t\t'lvi',\n\t\t\t\t'dvi',\n\t\t\t\t'vb',\n\t\t\t\t'svb',\n\t\t\t\t'lvb',\n\t\t\t\t'dvb',\n\t\t\t\t'vmin',\n\t\t\t\t'svmin',\n\t\t\t\t'lvmin',\n\t\t\t\t'dvmin',\n\t\t\t\t'vmax',\n\t\t\t\t'svmax',\n\t\t\t\t'lvmax',\n\t\t\t\t'dvmax',\n\t\t\t].includes( newUnit ) &&\n\t\t\tcurrentValue > 100\n\t\t) {\n\t\t\t// When converting to `%` or viewport-relative units, cap the new value at 100.\n\t\t\tonChange( 100 + newUnit );\n\t\t}\n\n\t\tsetSelectedUnit( newUnit );\n\t};\n\n\treturn (\n\t\t<fieldset className=\"block-editor-dimension-control\">\n\t\t\t<BaseControl.VisualLabel as=\"legend\">\n\t\t\t\t{ label }\n\t\t\t</BaseControl.VisualLabel>\n\t\t\t<PresetInputControl\n\t\t\t\tariaLabel={ label }\n\t\t\t\tclassName=\"block-editor-dimension-control\"\n\t\t\t\tcustomValueSettings={ DIMENSION_CUSTOM_VALUE_SETTINGS }\n\t\t\t\tminimumCustomValue={ 0 }\n\t\t\t\tonChange={ onChange }\n\t\t\t\tonUnitChange={ handleUnitChange }\n\t\t\t\tpresets={ options }\n\t\t\t\tpresetType=\"dimension\"\n\t\t\t\tselectedUnit={ selectedUnit }\n\t\t\t\tshowTooltip\n\t\t\t\tunits={ units }\n\t\t\t\tvalue={ value }\n\t\t\t/>\n\t\t</fieldset>\n\t);\n}\n"],
"mappings": "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",
"names": []
}