Add getFieldRef (#29)

Author: zoontek

README.md

@@ -89,6 +89,7 @@ const {
   Field,
   FieldsListener,
   getFieldValue,
+  getFieldRef,
   setFieldValue,
   setFieldError,
   focusField,
@@ -199,6 +200,14 @@ type getFieldValue = (
 ) => Value;
 ```
 
+#### getFieldRef
+
+Return the field stable `ref`.
+
+```tsx
+type getFieldRef = <T>(name: FieldName) => MutableRefObject<T>;
+```
+
 #### setFieldValue
 
 By setting `validate: true`, you will enforce validation. It has no effect if the field is already _talkative_.

src/types.ts

@@ -73,6 +73,7 @@ export type Form<Values extends Required<Values>, ErrorMessage = string> = {
   };
 
   getFieldValue: <N extends keyof Values>(name: N, options?: { sanitize?: boolean }) => Values[N];
+  getFieldRef: <T>(name: keyof Values) => MutableRefObject<T>;
   setFieldValue: <N extends keyof Values>(
     name: N,
     value: Values[N],

src/useForm.ts

@@ -127,6 +127,11 @@ export const useForm = <Values extends Required<Values>, ErrorMessage = string>(
       return sanitize ? getSanitize(name)(value) : value;
     };
 
+    const getFieldRef = <T>(name: Name) => {
+      const { ref } = fields.current[name];
+      return ref as MutableRefObject<T>;
+    };
+
     const focusField: Contract["focusField"] = (name) => {
       const { ref } = fields.current[name];
 
@@ -347,6 +352,7 @@ export const useForm = <Values extends Required<Values>, ErrorMessage = string>(
 
     return {
       getFieldValue,
+      getFieldRef,
       setFieldValue,
       setFieldError,
       focusField,
@@ -475,6 +481,7 @@ export const useForm = <Values extends Required<Values>, ErrorMessage = string>(
     FieldsListener: fieldsListener.current,
 
     getFieldValue: api.getFieldValue,
+    getFieldRef: api.getFieldRef,
     setFieldValue: api.setFieldValue,
     setFieldError: api.setFieldError,
     focusField: api.focusField,