Files
form/docs/framework/react/reference/Field.md

1.5 KiB

id, title
id title
field Field

FieldComponent<TParentData>

A type alias representing a field component for a specific form data type.

export type FieldComponent = <TField extends DeepKeys<TParentData>>({
  children,
  ...fieldOptions
}: {
  children: (
    fieldApi: FieldApi<DeepValue<TParentData, TField>, TParentData>,
  ) => any
  name: TField
} & Omit<
  FieldOptions<DeepValue<TParentData, TField>, TParentData>,
  'name'
>) => any

A function component that takes field options and a render function as children and returns a React component.

Field

export function Field<TData, TParentData>({
  children,
  ...fieldOptions
}: { children: (fieldApi: FieldApi<TData, TParentData>) => any } & FieldOptions<
  TData,
  TParentData
>): any

A functional React component that renders a form field.

  • children: (fieldApi: FieldApi<TData, TParentData>) => any
    
    • A render function that takes a field API instance and returns a React element.
  • fieldOptions: FieldOptions<TData, TParentData>
    
    • The field options.

The Field component uses the useField hook internally to manage the field instance.

createFieldComponent

export function createFieldComponent<TParentData>(
  formApi: FormApi<TParentData>,
): FieldComponent<TParentData>

A factory function that creates a connected field component for a specific form API instance.

  • formApi: FormApi<TParentData>
    
    • The form API instance to connect the field component to.