Source: https://tanstack.com/form/latest/docs/framework/vue/reference/functions/usefield

TanStack

Form v1v1

Search...

+ K

Auto

Log In

TanStack StartRC

Docs Examples GitHub Contributors

TanStack Router

Docs Examples GitHub Contributors

TanStack Query

Docs Examples GitHub Contributors

TanStack Table

Docs Examples Github Contributors

TanStack Formnew

Docs Examples Github Contributors

TanStack DBbeta

Docs Github Contributors

TanStack Virtual

Docs Examples Github Contributors

TanStack Paceralpha

Docs Examples Github Contributors

TanStack Storealpha

Docs Examples Github Contributors

TanStack Devtoolsalpha

Docs Github Contributors

More Libraries

Maintainers Partners Support Learn StatsBETA Discord Merch Blog GitHub Ethos Brand Guide

Documentation

Framework

Vue

Version

Latest

Search...

+ K

Menu

• Home

• Frameworks

• Contributors

• Community Resources

• GitHub

• Discord

Getting Started

• Overview
  
  core

• Installation
  
  core

• Philosophy
  
  core

• Comparison
  
  core

• TypeScript
  
  core

• Quick Start
  
  vue

Guides

• Basic Concepts
  
  vue

• Form Validation
  
  vue

• Dynamic Validation
  
  vue

• Async Initial Values
  
  vue

• Arrays
  
  vue

• Linked Fields
  
  vue

API Reference

• JavaScript Reference
  
  core

• Classes / FieldApi
  
  core

• Classes / FormApi
  
  core

• Functions / formOptions
  
  core

• Functions / mergeForm
  
  core

• Interfaces / FieldApiOptions
  
  core

• Interfaces / FieldOptions
  
  core

• Interfaces / FieldValidators
  
  core

• Interfaces / FormOptions
  
  core

• Interfaces / FormValidators
  
  core

• Types / DeepKeys
  
  core

• Types / DeepValue
  
  core

• Types / FieldInfo
  
  core

• Types / FieldMeta
  
  core

• Types / FieldState
  
  core

• Types / BaseFormState
  
  core

• Types / DerivedFormState
  
  core

• Types / Updater
  
  core

• Types / UpdaterFn
  
  core

• Types / ValidationError
  
  core

• Types / ValidationMeta
  
  core

• Vue Reference
  
  vue

• Functions / Field
  
  vue

• Functions / useField
  
  vue

• Functions / useForm
  
  vue

• Types / FieldComponent
  
  vue

• Types / UseField
  
  vue

Examples

• Simple
  
  vue

• Arrays
  
  vue

• Standard Schema
  
  vue

Framework

Vue

Version

Latest

Menu

• Home

• Frameworks

• Contributors

• Community Resources

• GitHub

• Discord

Getting Started

• Overview
  
  core

• Installation
  
  core

• Philosophy
  
  core

• Comparison
  
  core

• TypeScript
  
  core

• Quick Start
  
  vue

Guides

• Basic Concepts
  
  vue

• Form Validation
  
  vue

• Dynamic Validation
  
  vue

• Async Initial Values
  
  vue

• Arrays
  
  vue

• Linked Fields
  
  vue

API Reference

• JavaScript Reference
  
  core

• Classes / FieldApi
  
  core

• Classes / FormApi
  
  core

• Functions / formOptions
  
  core

• Functions / mergeForm
  
  core

• Interfaces / FieldApiOptions
  
  core

• Interfaces / FieldOptions
  
  core

• Interfaces / FieldValidators
  
  core

• Interfaces / FormOptions
  
  core

• Interfaces / FormValidators
  
  core

• Types / DeepKeys
  
  core

• Types / DeepValue
  
  core

• Types / FieldInfo
  
  core

• Types / FieldMeta
  
  core

• Types / FieldState
  
  core

• Types / BaseFormState
  
  core

• Types / DerivedFormState
  
  core

• Types / Updater
  
  core

• Types / UpdaterFn
  
  core

• Types / ValidationError
  
  core

• Types / ValidationMeta
  
  core

• Vue Reference
  
  vue

• Functions / Field
  
  vue

• Functions / useField
  
  vue

• Functions / useForm
  
  vue

• Types / FieldComponent
  
  vue

• Types / UseField
  
  vue

Examples

• Simple
  
  vue

• Arrays
  
  vue

• Standard Schema
  
  vue

On this page

• Function: useField()

• Type Parameters

• Parameters

• opts

• Returns

• api

• state

useField

Copy Markdown

Function: useField()
====================

ts

function useField<TParentData, TName, TData, TOnMount, TOnChange, TOnChangeAsync, TOnBlur, TOnBlurAsync, TOnSubmit, TOnSubmitAsync, TOnDynamic, TOnDynamicAsync, TFormOnMount, TFormOnChange, TFormOnChangeAsync, TFormOnBlur, TFormOnBlurAsync, TFormOnSubmit, TFormOnSubmitAsync, TFormOnDynamic, TFormOnDynamicAsync, TFormOnServer, TParentSubmitMeta>(opts): object


function useField<TParentData, TName, TData, TOnMount, TOnChange, TOnChangeAsync, TOnBlur, TOnBlurAsync, TOnSubmit, TOnSubmitAsync, TOnDynamic, TOnDynamicAsync, TFormOnMount, TFormOnChange, TFormOnChangeAsync, TFormOnBlur, TFormOnBlurAsync, TFormOnSubmit, TFormOnSubmitAsync, TFormOnDynamic, TFormOnDynamicAsync, TFormOnServer, TParentSubmitMeta>(opts): object

Defined in: packages/vue-form/src/useField.tsx:307

Type Parameters
---------------

• TParentData

• TName extends string

• TData

• TOnMount extends undefined | FieldValidateOrFn<TParentData, TName, TData>

• TOnChange extends undefined | FieldValidateOrFn<TParentData, TName, TData>

• TOnChangeAsync extends undefined | FieldAsyncValidateOrFn<TParentData, TName, TData>

• TOnBlur extends undefined | FieldValidateOrFn<TParentData, TName, TData>

• TOnBlurAsync extends undefined | FieldAsyncValidateOrFn<TParentData, TName, TData>

• TOnSubmit extends undefined | FieldValidateOrFn<TParentData, TName, TData>

• TOnSubmitAsync extends undefined | FieldAsyncValidateOrFn<TParentData, TName, TData>

• TOnDynamic extends undefined | FieldValidateOrFn<TParentData, TName, TData>

• TOnDynamicAsync extends undefined | FieldAsyncValidateOrFn<TParentData, TName, TData>

• TFormOnMount extends undefined | FormValidateOrFn<TParentData>

• TFormOnChange extends undefined | FormValidateOrFn<TParentData>

• TFormOnChangeAsync extends undefined | FormAsyncValidateOrFn<TParentData>

• TFormOnBlur extends undefined | FormValidateOrFn<TParentData>

• TFormOnBlurAsync extends undefined | FormAsyncValidateOrFn<TParentData>

• TFormOnSubmit extends undefined | FormValidateOrFn<TParentData>

• TFormOnSubmitAsync extends undefined | FormAsyncValidateOrFn<TParentData>

• TFormOnDynamic extends undefined | FormValidateOrFn<TParentData>

• TFormOnDynamicAsync extends undefined | FormAsyncValidateOrFn<TParentData>

• TFormOnServer extends undefined | FormAsyncValidateOrFn<TParentData>

• TParentSubmitMeta

Parameters
---------- ### opts

UseFieldOptions<TParentData, TName, TData, TOnMount, TOnChange, TOnChangeAsync, TOnBlur, TOnBlurAsync, TOnSubmit, TOnSubmitAsync, TOnDynamic, TOnDynamicAsync, TFormOnMount, TFormOnChange, TFormOnChangeAsync, TFormOnBlur, TFormOnBlurAsync, TFormOnSubmit, TFormOnSubmitAsync, TFormOnDynamic, TFormOnDynamicAsync, TFormOnServer, TParentSubmitMeta>

Returns
-------

object

### api

ts

readonly api: FieldApi<TParentData, TName, TData, TOnMount, TOnChange, TOnChangeAsync, TOnBlur, TOnBlurAsync, TOnSubmit, TOnSubmitAsync, TOnDynamic, TOnDynamicAsync, TFormOnMount, TFormOnChange, TFormOnChangeAsync, TFormOnBlur, TFormOnBlurAsync, TFormOnSubmit, TFormOnSubmitAsync, TFormOnDynamic, TFormOnDynamicAsync, TFormOnServer, TParentSubmitMeta> & VueFieldApi<TParentData, TFormOnMount, TFormOnChange, TFormOnChangeAsync, TFormOnBlur, TFormOnBlurAsync, TFormOnSubmit, TFormOnSubmitAsync, TFormOnDynamic, TFormOnDynamicAsync, TFormOnServer, TParentSubmitMeta> = fieldApi;


readonly api: FieldApi<TParentData, TName, TData, TOnMount, TOnChange, TOnChangeAsync, TOnBlur, TOnBlurAsync, TOnSubmit, TOnSubmitAsync, TOnDynamic, TOnDynamicAsync, TFormOnMount, TFormOnChange, TFormOnChangeAsync, TFormOnBlur, TFormOnBlurAsync, TFormOnSubmit, TFormOnSubmitAsync, TFormOnDynamic, TFormOnDynamicAsync, TFormOnServer, TParentSubmitMeta> & VueFieldApi<TParentData, TFormOnMount, TFormOnChange, TFormOnChangeAsync, TFormOnBlur, TFormOnBlurAsync, TFormOnSubmit, TFormOnSubmitAsync, TFormOnDynamic, TFormOnDynamicAsync, TFormOnServer, TParentSubmitMeta> = fieldApi;

### state

ts

readonly state: Readonly<Ref<FieldState<TParentData, TName, TData, TOnMount, TOnChange, TOnChangeAsync, TOnBlur, TOnBlurAsync, TOnSubmit, TOnSubmitAsync, TOnDynamic, TOnDynamicAsync, TFormOnMount, TFormOnChange, TFormOnChangeAsync, TFormOnBlur, TFormOnBlurAsync, TFormOnSubmit, TFormOnSubmitAsync, TFormOnDynamic, TFormOnDynamicAsync>, FieldState<TParentData, TName, TData, TOnMount, TOnChange, TOnChangeAsync, TOnBlur, TOnBlurAsync, TOnSubmit, TOnSubmitAsync, TOnDynamic, TOnDynamicAsync, TFormOnMount, TFormOnChange, TFormOnChangeAsync, TFormOnBlur, TFormOnBlurAsync, TFormOnSubmit, TFormOnSubmitAsync, TFormOnDynamic, TFormOnDynamicAsync>>> = fieldState;


readonly state: Readonly<Ref<FieldState<TParentData, TName, TData, TOnMount, TOnChange, TOnChangeAsync, TOnBlur, TOnBlurAsync, TOnSubmit, TOnSubmitAsync, TOnDynamic, TOnDynamicAsync, TFormOnMount, TFormOnChange, TFormOnChangeAsync, TFormOnBlur, TFormOnBlurAsync, TFormOnSubmit, TFormOnSubmitAsync, TFormOnDynamic, TFormOnDynamicAsync>, FieldState<TParentData, TName, TData, TOnMount, TOnChange, TOnChangeAsync, TOnBlur, TOnBlurAsync, TOnSubmit, TOnSubmitAsync, TOnDynamic, TOnDynamicAsync, TFormOnMount, TFormOnChange, TFormOnChangeAsync, TFormOnBlur, TFormOnBlurAsync, TFormOnSubmit, TFormOnSubmitAsync, TFormOnDynamic, TFormOnDynamicAsync>>> = fieldState;

Edit on GitHub

Functions / Field

Functions / useForm

Partners Become a Partner