rsuite/esm/internals/hooks/useControlled.js

A suite of react components

'use client';
import { useRef, useState, useCallback } from 'react';
/**
 * A hook for controlled value management.
 * In the case of passing the controlled value, the controlled value is returned, otherwise the value in state is returned.
 * Generally used for a component including controlled and uncontrolled modes.
 * @param controlledValue
 * @param defaultValue
 * @param formatValue
 */

export function useControlled(controlledValue, defaultValue) {
  var controlledRef = useRef(false);
  controlledRef.current = controlledValue !== undefined;
  var _useState = useState(defaultValue),
    uncontrolledValue = _useState[0],
    setUncontrolledValue = _useState[1];

  // If it is controlled, this directly returns the attribute value.
  var value = controlledRef.current ? controlledValue : uncontrolledValue;
  var setValue = useCallback(function (nextValue) {
    // Only update the value in state when it is not under control.
    if (!controlledRef.current) {
      setUncontrolledValue(nextValue);
    }
  }, [controlledRef]);
  return [value, setValue, controlledRef.current];
}
export default useControlled;