---
url: "https://vueda.dev/v3/reference/api/js/use/useField.md"
title: "use/useField"
---

# use/useField

## Overview

Provides reactive field context including value tracking, validation, required-state, and server error handling for individual form fields.

## Properties

### FIELD_EMITS {#FIELD_EMITS}

Array of Vue event names emitted by field components. Pass to the `emits` option of a field component.

@vueda-spread emits

Type: `string[]`

Source: `client/lib/use/useField.js:68`

### FIELD_PROPS {#FIELD_PROPS}

Vue component props definition for field components. Spread into component options to include
standard field identification, validation, display, value handling, and form context behavior props.

@vueda-spread props

Type: `object`

Source: `client/lib/use/useField.js:21`

## Methods

- [defaultIsRequiredViolation](/v3/reference/api/js/use/useField/functions/defaultIsRequiredViolation.md) - Determines whether a value would **violate a required field rule**.
- [isUnsetValue](/v3/reference/api/js/use/useField/functions/isUnsetValue.md) - Determines whether a field's value is **unset** (i.e., it has not been explicitly set).
- [useField](/v3/reference/api/js/use/useField/functions/useField.md) - Generate and provide a field context for a field.

## Types

### [FieldContext](/v3/reference/api/js/use/useField/types/FieldContext.md)

### [FieldContextRawProps](/v3/reference/api/js/use/useField/types/FieldContextRawProps.md)

### [FieldContextRawState](/v3/reference/api/js/use/useField/types/FieldContextRawState.md)

### [FieldContextTestProps](/v3/reference/api/js/use/useField/types/FieldContextTestProps.md)

### [UseFieldOptions](/v3/reference/api/js/use/useField/types/UseFieldOptions.md)

### [FieldContextProps](/v3/reference/api/js/use/useField/types/FieldContextProps.md)

`FieldContextProps = UnwrapNestedRefs`

### [FieldContextState](/v3/reference/api/js/use/useField/types/FieldContextState.md)

`FieldContextState = UnwrapNestedRefs`

## Source

`client/lib/use/useField.js:1`