New to KendoReactStart a free 30-day trial

FormProps

Interface

Contains the props for the KendoReact Form component.

Definition

Package:@progress/kendo-react-form

Properties

errors?

{ [name: string]: string }

Validation errors that override field and form validators.

Provides validation errors directly as an object, unlike the validator prop which expects a callback. When both validator and errors exist for a field, the errors prop takes precedence.

Allows the form to submit even when no fields have been modified.

initialValues?

{ [name: string]: any }

Sets the starting values for form fields.

Set initial values to prevent errors when switching from uncontrolled to controlled mode.

onChange?

(fieldName: string, value: any, valueGetter: (name: string) => any) => void

Fires each time any field value changes.

The third parameter valueGetter allows accessing other field values, useful for cross-field validation or clearing related errors.

Parameters:fieldNamestringvalueanyvalueGetter(name: string) => any

onSubmit?

(values: { [name: string]: any }, event: SyntheticEvent​<any, Event>) => void

Handles form submission when validation passes and fields are modified.

Fires when at least one field is modified, the user clicks Submit, and validation passes.

Parameters:values{ [name: string]: any }event?SyntheticEvent​<any, Event>

Handles every submit button click, even when the form is invalid or unchanged.

Use this for advanced scenarios where you need to handle all submit events.

Parameters:eventFormSubmitClickEvent

Renders the form content using the provided render function.

Parameters:propsFormRenderPropsReturns:

any

Validates the entire form and returns error messages.

Return a key-value pair where the key is the field path and the value is the error message. You can validate nested fields like 'users[0].name'. Only synchronous functions are supported.

webMcp?

boolean | WebMcpProps

Enables browser-native AI agent tools via Web MCP (Chrome 146+).

Pass true for defaults or an object for fine-grained control. AI agents are multilingual — dataName accepts any language.