@wordpress/components
Version:
UI components for WordPress.
1 lines • 1.93 kB
Source Map (JSON)
{"version":3,"file":"use-controlled-value.mjs","names":[],"sources":["../../../src/utils/hooks/use-controlled-value.ts"],"sourcesContent":["import { useCallback, useState } from '@wordpress/element';\n\ntype Props< T > = {\n\tdefaultValue?: T;\n\tvalue?: T;\n\tonChange?: ( value: T, ...args: any[] ) => void;\n};\n\n/**\n * Simplified and improved implementation of useControlledState.\n *\n * @param props\n * @param props.defaultValue\n * @param props.value\n * @param props.onChange\n * @return The controlled value and the value setter.\n */\nexport function useControlledValue< T >( {\n\tdefaultValue,\n\tonChange,\n\tvalue: valueProp,\n}: Props< T > ) {\n\tconst hasValue = typeof valueProp !== 'undefined';\n\tconst initialValue = hasValue ? valueProp : defaultValue;\n\tconst [ state, setState ] = useState( initialValue );\n\tconst value = hasValue ? valueProp : state;\n\n\tconst uncontrolledSetValue = useCallback(\n\t\t( nextValue: T, ...args: any[] ) => {\n\t\t\tsetState( nextValue );\n\t\t\tonChange?.( nextValue, ...args );\n\t\t},\n\t\t[ onChange ]\n\t);\n\n\tlet setValue: typeof onChange;\n\tif ( hasValue && typeof onChange === 'function' ) {\n\t\t// Controlled mode.\n\t\tsetValue = onChange;\n\t} else if ( ! hasValue && typeof onChange === 'function' ) {\n\t\t// Uncontrolled mode, plus forwarding to the onChange prop.\n\t\tsetValue = uncontrolledSetValue;\n\t} else {\n\t\t// Uncontrolled mode, only update internal state.\n\t\tsetValue = setState;\n\t}\n\n\treturn [ value, setValue ] as const;\n}\n"],"mappings":";;;;;;;;;;;AAiBA,SAAgB,mBAAyB,EACxC,cACA,UACA,OAAO,aACQ;CACf,MAAM,WAAW,OAAO,cAAc;CAEtC,MAAM,CAAE,OAAO,YAAa,SADP,WAAW,YAAY,YACO;CACnD,MAAM,QAAQ,WAAW,YAAY;CAErC,MAAM,uBAAuB,aAC1B,WAAc,GAAG,SAAiB;EACnC,SAAU,SAAU;EACpB,WAAY,WAAW,GAAG,IAAK;CAChC,GACA,CAAE,QAAS,CACZ;CAEA,IAAI;CACJ,IAAK,YAAY,OAAO,aAAa,YAEpC,WAAW;MACL,IAAK,CAAE,YAAY,OAAO,aAAa,YAE7C,WAAW;MAGX,WAAW;CAGZ,OAAO,CAAE,OAAO,QAAS;AAC1B"}