/** * External Dependencies */ import 'select2'; import jQuery from 'jquery'; import shallowEqualFuzzy from 'shallow-equal-fuzzy'; /** * WordPress Dependencies */ import { useEffect, useRef, useState, forwardRef } from '@wordpress/element'; const namespace = 'react-select2'; const Select2 = forwardRef( ( props, ref ) => { const { defaultValue = '', value: propValue, data = [], events = [ [ `change.${ namespace }`, 'onChange' ], [ `select2:open.${ namespace }`, 'onOpen' ], [ `select2:close.${ namespace }`, 'onClose' ], [ `select2:select.${ namespace }`, 'onSelect' ], [ `select2:unselect.${ namespace }`, 'onUnselect' ], ], options = {}, onChange, onOpen, onClose, onSelect, onUnselect, ...rest } = props; const internalRef = useRef( null ); const selectRef = ref || internalRef; const [ internalValue ] = useState( propValue || defaultValue ); useEffect( () => { const $el = jQuery( selectRef.current ); // Initialize select2 $el.select2( prepareOptions( options ) ); attachEventHandlers( $el ); // Set initial value updateSelect2Value( $el, internalValue ); return () => { // Cleanup: destroy select2 instance detachEventHandlers( $el ); $el.select2( 'destroy' ); }; // eslint-disable-next-line react-hooks/exhaustive-deps -- initialize select2 once on mount, destroy on unmount. }, [] ); useEffect( () => { const $el = jQuery( selectRef.current ); // Update select2 options if they change $el.select2( prepareOptions( options ) ); // Update value if propValue changes if ( propValue !== undefined && ! fuzzyValuesEqual( $el.val(), propValue ) ) { updateSelect2Value( $el, propValue ); } // eslint-disable-next-line react-hooks/exhaustive-deps -- only react to propValue/options; the helper functions are redefined every render. }, [ propValue, options ] ); const prepareOptions = ( rawOptions ) => { const opt = { ...rawOptions }; if ( typeof opt.dropdownParent === 'string' ) { opt.dropdownParent = jQuery( opt.dropdownParent ); } return opt; }; const attachEventHandlers = ( $el ) => { const handlers = { onChange, onOpen, onClose, onSelect, onUnselect }; events.forEach( ( [ event, handlerName ] ) => { if ( handlers[ handlerName ] ) { $el.on( event, handlers[ handlerName ] ); } } ); }; const detachEventHandlers = ( $el ) => { events.forEach( ( [ event ] ) => { $el.off( event ); } ); }; const updateSelect2Value = ( $el, value ) => { $el.off( `change.${ namespace }` ).val( value ).trigger( 'change' ); if ( onChange ) { $el.on( `change.${ namespace }`, onChange ); } }; const fuzzyValuesEqual = ( currentValue, newValue ) => { return ( ( currentValue === null && newValue === '' ) || shallowEqualFuzzy( currentValue, newValue ) ); }; const makeOption = ( item ) => { if ( typeof item === 'object' ) { const { value, label, ...itemParams } = item; return ( ); } return ( ); }; return ( ); } ); export default Select2;