UNPKG

@wordpress/components

Version:
265 lines (221 loc) 8.05 kB
"use strict"; Object.defineProperty(exports, "__esModule", { value: true }); exports.useInputControlStateReducer = useInputControlStateReducer; var _element = require("@wordpress/element"); var _state = require("./state"); var actions = _interopRequireWildcard(require("./actions")); function _getRequireWildcardCache(nodeInterop) { if (typeof WeakMap !== "function") return null; var cacheBabelInterop = new WeakMap(); var cacheNodeInterop = new WeakMap(); return (_getRequireWildcardCache = function (nodeInterop) { return nodeInterop ? cacheNodeInterop : cacheBabelInterop; })(nodeInterop); } function _interopRequireWildcard(obj, nodeInterop) { if (!nodeInterop && obj && obj.__esModule) { return obj; } if (obj === null || typeof obj !== "object" && typeof obj !== "function") { return { default: obj }; } var cache = _getRequireWildcardCache(nodeInterop); if (cache && cache.has(obj)) { return cache.get(obj); } var newObj = {}; var hasPropertyDescriptor = Object.defineProperty && Object.getOwnPropertyDescriptor; for (var key in obj) { if (key !== "default" && Object.prototype.hasOwnProperty.call(obj, key)) { var desc = hasPropertyDescriptor ? Object.getOwnPropertyDescriptor(obj, key) : null; if (desc && (desc.get || desc.set)) { Object.defineProperty(newObj, key, desc); } else { newObj[key] = obj[key]; } } } newObj.default = obj; if (cache) { cache.set(obj, newObj); } return newObj; } /** * External dependencies */ /** * WordPress dependencies */ /** * Internal dependencies */ /** * Prepares initialState for the reducer. * * @param initialState The initial state. * @return Prepared initialState for the reducer */ function mergeInitialState() { let initialState = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : _state.initialInputControlState; const { value } = initialState; return { ..._state.initialInputControlState, ...initialState, initialValue: value }; } /** * Creates the base reducer which may be coupled to a specializing reducer. * As its final step, for all actions other than CONTROL, the base reducer * passes the state and action on through the specializing reducer. The * exception for CONTROL actions is because they represent controlled updates * from props and no case has yet presented for their specialization. * * @param composedStateReducers A reducer to specialize state changes. * @return The reducer. */ function inputControlStateReducer(composedStateReducers) { return (state, action) => { const nextState = { ...state }; switch (action.type) { /* * Controlled updates */ case actions.CONTROL: nextState.value = action.payload.value; nextState.isDirty = false; nextState._event = undefined; // Returns immediately to avoid invoking additional reducers. return nextState; /** * Keyboard events */ case actions.PRESS_UP: nextState.isDirty = false; break; case actions.PRESS_DOWN: nextState.isDirty = false; break; /** * Drag events */ case actions.DRAG_START: nextState.isDragging = true; break; case actions.DRAG_END: nextState.isDragging = false; break; /** * Input events */ case actions.CHANGE: nextState.error = null; nextState.value = action.payload.value; if (state.isPressEnterToChange) { nextState.isDirty = true; } break; case actions.COMMIT: nextState.value = action.payload.value; nextState.isDirty = false; break; case actions.RESET: nextState.error = null; nextState.isDirty = false; nextState.value = action.payload.value || state.initialValue; break; /** * Validation */ case actions.INVALIDATE: nextState.error = action.payload.error; break; } nextState._event = action.payload.event; /** * Send the nextState + action to the composedReducers via * this "bridge" mechanism. This allows external stateReducers * to hook into actions, and modify state if needed. */ return composedStateReducers(nextState, action); }; } /** * A custom hook that connects and external stateReducer with an internal * reducer. This hook manages the internal state of InputControl. * However, by connecting an external stateReducer function, other * components can react to actions as well as modify state before it is * applied. * * This technique uses the "stateReducer" design pattern: * https://kentcdodds.com/blog/the-state-reducer-pattern/ * * @param stateReducer An external state reducer. * @param initialState The initial state for the reducer. * @param onChangeHandler A handler for the onChange event. * @return State, dispatch, and a collection of actions. */ function useInputControlStateReducer() { let stateReducer = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : _state.initialStateReducer; let initialState = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : _state.initialInputControlState; let onChangeHandler = arguments.length > 2 ? arguments[2] : undefined; const [state, dispatch] = (0, _element.useReducer)(inputControlStateReducer(stateReducer), mergeInitialState(initialState)); const createChangeEvent = type => (nextValue, event) => { dispatch({ type, payload: { value: nextValue, event } }); }; const createKeyEvent = type => event => { dispatch({ type, payload: { event } }); }; const createDragEvent = type => payload => { dispatch({ type, payload }); }; /** * Actions for the reducer */ const change = createChangeEvent(actions.CHANGE); const invalidate = (error, event) => dispatch({ type: actions.INVALIDATE, payload: { error, event } }); const reset = createChangeEvent(actions.RESET); const commit = createChangeEvent(actions.COMMIT); const dragStart = createDragEvent(actions.DRAG_START); const drag = createDragEvent(actions.DRAG); const dragEnd = createDragEvent(actions.DRAG_END); const pressUp = createKeyEvent(actions.PRESS_UP); const pressDown = createKeyEvent(actions.PRESS_DOWN); const pressEnter = createKeyEvent(actions.PRESS_ENTER); const currentState = (0, _element.useRef)(state); const refProps = (0, _element.useRef)({ value: initialState.value, onChangeHandler }); // Freshens refs to props and state so that subsequent effects have access // to their latest values without their changes causing effect runs. (0, _element.useLayoutEffect)(() => { currentState.current = state; refProps.current = { value: initialState.value, onChangeHandler }; }); // Propagates the latest state through onChange. (0, _element.useLayoutEffect)(() => { if (currentState.current._event !== undefined && state.value !== refProps.current.value && !state.isDirty) { var _state$value; refProps.current.onChangeHandler((_state$value = state.value) !== null && _state$value !== void 0 ? _state$value : '', { event: currentState.current._event }); } }, [state.value, state.isDirty]); // Updates the state from props. (0, _element.useLayoutEffect)(() => { if (initialState.value !== currentState.current.value && !currentState.current.isDirty) { var _initialState$value; dispatch({ type: actions.CONTROL, payload: { value: (_initialState$value = initialState.value) !== null && _initialState$value !== void 0 ? _initialState$value : '' } }); } }, [initialState.value]); return { change, commit, dispatch, drag, dragEnd, dragStart, invalidate, pressDown, pressEnter, pressUp, reset, state }; } //# sourceMappingURL=reducer.js.map