Function useCheckbox

packages/react-aria/src/checkbox/useCheckbox.ts:62–113

(
  props: AriaCheckboxProps,
  state: ToggleState,
  inputRef: RefObject<HTMLInputElement | null>
)

 * @param inputRef - A ref for the HTML input element.
 */
export function useCheckbox(
  props: AriaCheckboxProps,
  state: ToggleState,
  inputRef: RefObject<HTMLInputElement | null>
): CheckboxAria {
  let {
    labelProps,
    inputProps,
    descriptionProps,
    errorMessageProps,
    isSelected,
    isPressed,
    isDisabled,
    isReadOnly,
    isInvalid,
    validationErrors,
    validationDetails
  } = useToggle(props, state, inputRef);

  let {isIndeterminate} = props;
  useEffect(() => {
    // indeterminate is a property, but it can only be set via javascript
    // https://css-tricks.com/indeterminate-checkboxes/
    if (inputRef.current) {
      inputRef.current.indeterminate = !!isIndeterminate;
    }
  });

  return {
    labelProps: mergeProps(
      labelProps,
      useMemo(
        () => ({
          // Prevent label from being focused when mouse down on it.
          // Note, this does not prevent the input from being focused in the `click` event.
          onMouseDown: e => e.preventDefault()
        }),
        []
      )
    ),
    inputProps,
    descriptionProps,
    errorMessageProps,
    isSelected,
    isPressed,
    isDisabled,
    isReadOnly,
    isInvalid,
    validationErrors,
    validationDetails
  };
}