Skip to content
Source
Sign inSign up
TanStack/form
Open History to see the last commit

CreateFormHookOptions.md

150 lines3.8 KB

Defined in: packages/vue-form/src/AppForm/createFormHookTypes.public.ts:46

Configures the components and reusable defaults returned by createFormHook.

Form core resolves each default object before the corresponding usage-site options. Non-listener properties passed at the usage site take precedence, including when explicitly set to undefined. Listener arrays follow the configured listenersMerge strategy.

Example

const { useAppForm } = createFormHook({
  formComponents: {},
  fieldComponents: {
    TextField,
  },
  defaultFormOptions: {
    errorVisibility: ({ fieldState }) => fieldState.meta.isBlurred,
  },
  defaultFieldOptions: {
    errorBoundary: true,
  },
})

Extends

Type Parameters

TFormComponents

TFormComponents extends Record<string, Component>

Library-managed. Do not specify explicitly.

TFieldComponents

TFieldComponents extends Record<string, Component>

Library-managed. Do not specify explicitly.

Properties

defaultFieldOptions?

optional defaultFieldOptions?: DefaultFieldOptions;

Defined in: packages/vue-form/src/AppForm/createFormHookTypes.public.ts:79

Defaults for every field and array-field component owned by the form.

Non-listener options passed to the component override these defaults, including when explicitly set to undefined. Listener arrays follow listenersMerge. This includes group.Field and group.ArrayField.

Example

defaultFieldOptions: {
  errorVisibility: ({ fieldState }) => fieldState.meta.isBlurred,
},

defaultFormGroupOptions?

optional defaultFormGroupOptions?: DefaultFormGroupOptions;

Defined in: packages/vue-form/src/AppForm/createFormHookTypes.public.ts:95

Defaults for every form.FormGroup component.

Options passed to the component override these defaults, including when an option is explicitly undefined.

Example

defaultFormGroupOptions: {
  onSubmitInvalid: ({ groupApi }) => {
    console.error('Invalid group', groupApi.name)
  },
},

defaultFormOptions?

optional defaultFormOptions?: DefaultFormOptions;

Defined in: packages/vue-form/src/AppForm/createFormHookTypes.public.ts:64

Defaults for every form created by useAppForm.

Non-listener options passed to useAppForm override these defaults, including when explicitly set to undefined. Listener arrays follow listenersMerge.

Example

defaultFormOptions: {
  errorVisibility: ({ state }) => state.submissionAttempts > 0,
},

fieldComponents

fieldComponents: TFieldComponents;

Defined in: packages/vue-form/src/AppForm/componentMap.public.ts:8

Inherited from

VueFormComponentMap.fieldComponents


formComponents

formComponents: TFormComponents;

Defined in: packages/vue-form/src/AppForm/componentMap.public.ts:7

Inherited from

VueFormComponentMap.formComponents