Skip to content

resetField

Reset field state and value

resetField: (name: string, options?: Record<string, boolean | any>) => void

Reset an individual field state.

Props

After invoke this function.

  • isValid form state will be reevaluated.

  • isDirty form state will be reevaluated.

ResetField has the ability to retain field state. Here are the options you may want to use:

NameTypeDescription
namestring

registered field name.

optionskeepErrorboolean

When set to true, field error will be retained.

keepDirtyboolean

When set to true, dirtyFields will be retained.

keepTouchedboolean

When set to true, touchedFields state will be unchanged.

defaultValueunknown

When this value is not provided, field will be revert back to it's defaultValue.

When this value is provided:

  1. field will be updated with the supplied value.

  2. field's defaultValue will be updated to this value.

Rules

  • name need to match registered field name.

Examples

Video

The following video tutorial demonstrates resetField API.

Thank you for your support

If you find React Hook Form to be useful in your project, please consider to star and support it.

Edit