/** * External dependencies */ import { useEffect, useState, useCallback, forwardRef, useImperativeHandle, useRef, } from '@wordpress/element'; import classnames from 'classnames'; import { isObject } from '@woocommerce/types'; import { useDispatch, useSelect } from '@wordpress/data'; import { VALIDATION_STORE_KEY } from '@woocommerce/block-data'; import { usePrevious } from '@woocommerce/base-hooks'; import { useInstanceId } from '@wordpress/compose'; /** * Internal dependencies */ import TextInput from './text-input'; import './style.scss'; import { ValidationInputError } from '../validation-input-error'; import { getValidityMessageForInput } from '../../utils'; import { ValidatedTextInputProps } from './types'; export type ValidatedTextInputHandle = { revalidate: () => void; }; /** * A text based input which validates the input value. */ const ValidatedTextInput = forwardRef< ValidatedTextInputHandle, ValidatedTextInputProps >( ( { className, id, ariaDescribedBy, errorId, focusOnMount = false, onChange, showError = true, errorMessage: passedErrorMessage = '', value = '', customValidation = () => true, customFormatter = ( newValue: string ) => newValue, label, validateOnMount = true, instanceId: preferredInstanceId, ...rest }, forwardedRef ): JSX.Element => { // True on mount. const [ isPristine, setIsPristine ] = useState( true ); // Track incoming value. const previousValue = usePrevious( value ); // Ref for the input element. const inputRef = useRef< HTMLInputElement >( null ); const instanceId = useInstanceId( ValidatedTextInput, '', preferredInstanceId ); const textInputId = typeof id !== 'undefined' ? id : 'textinput-' + instanceId; const errorIdString = errorId !== undefined ? errorId : textInputId; const { setValidationErrors, hideValidationError, clearValidationError, } = useDispatch( VALIDATION_STORE_KEY ); const { validationError, validationErrorId } = useSelect( ( select ) => { const store = select( VALIDATION_STORE_KEY ); return { validationError: store.getValidationError( errorIdString ), validationErrorId: store.getValidationErrorId( errorIdString ), }; } ); const validateInput = useCallback( ( errorsHidden = true ) => { const inputObject = inputRef.current || null; if ( inputObject === null ) { return; } // Trim white space before validation. inputObject.value = inputObject.value.trim(); inputObject.setCustomValidity( '' ); if ( inputObject.checkValidity() && customValidation( inputObject ) ) { clearValidationError( errorIdString ); return; } setValidationErrors( { [ errorIdString ]: { message: label ? getValidityMessageForInput( label, inputObject ) : inputObject.validationMessage, hidden: errorsHidden, }, } ); }, [ clearValidationError, customValidation, errorIdString, setValidationErrors, label, ] ); // Allows parent to trigger revalidation. useImperativeHandle( forwardedRef, function () { return { revalidate() { validateInput( ! value ); }, }; }, [ validateInput, value ] ); /** * Handle browser autofill / changes via data store. * * Trigger validation on incoming state change if the current element is not in focus. This is because autofilled * elements do not trigger the blur() event, and so values can be validated in the background if the state changes * elsewhere. * * Errors are immediately visible. */ useEffect( () => { if ( value !== previousValue && ( value || previousValue ) && inputRef && inputRef.current !== null && inputRef.current?.ownerDocument?.activeElement !== inputRef.current ) { const formattedValue = customFormatter( inputRef.current.value ); if ( formattedValue !== value ) { onChange( formattedValue ); } else { validateInput( true ); } } }, [ validateInput, customFormatter, value, previousValue, onChange ] ); /** * Validation on mount. * * If the input is in pristine state on mount, focus the element (if focusOnMount is enabled), and validate in the * background. * * Errors are hidden until blur. */ useEffect( () => { if ( ! isPristine ) { return; } if ( focusOnMount ) { inputRef.current?.focus(); } // if validateOnMount is false, only validate input if focusOnMount is also false if ( validateOnMount || ! focusOnMount ) { validateInput( true ); } setIsPristine( false ); }, [ validateOnMount, focusOnMount, isPristine, setIsPristine, validateInput, ] ); // Remove validation errors when unmounted. useEffect( () => { return () => { clearValidationError( errorIdString ); }; }, [ clearValidationError, errorIdString ] ); if ( passedErrorMessage !== '' && isObject( validationError ) ) { validationError.message = passedErrorMessage; } const hasError = validationError?.message && ! validationError?.hidden; const describedBy = showError && hasError && validationErrorId ? validationErrorId : ariaDescribedBy; return ( ) } ref={ inputRef } onChange={ ( newValue ) => { // Hide errors while typing. hideValidationError( errorIdString ); // Validate the input value. validateInput( true ); // Push the changes up to the parent component. const formattedValue = customFormatter( newValue ); if ( formattedValue !== value ) { onChange( formattedValue ); } } } onBlur={ () => validateInput( false ) } ariaDescribedBy={ describedBy } value={ value } title="" label={ label } { ...rest } /> ); } ); export default ValidatedTextInput;