Skip to content

Errors

Error settings control how error messages are displayed and when validation is triggered when form validation fails. It contains one Validation sub-tab.

Validation

Validation Error Position

The display position of validation error messages. Options:

  • Below the field: The error message is displayed below the field
  • Position absolute (default): The error message is displayed with absolute positioning (floating above the field, without taking up layout space)

Difference Between the Two Positions

  • Below the field: The error message takes up space, and the form layout adjusts as errors are displayed
  • Position absolute: The error message floats and does not affect the form layout, providing a more stable visual effect

Event Trigger

When validation is triggered. Options:

  • Blur (default): Validation triggers when the field loses focus (when the user clicks/moves to another location)
  • Submit: Validation triggers all at once when the user clicks the submit button

Trigger Method Selection

  • Blur: Real-time feedback; the user immediately knows whether there is an error when leaving the field (recommended, better user experience)
  • Submit: Unified feedback; all errors are displayed at once upon submission (suitable for simple forms with few fields)

Show One Message

When on, only one validation error message is displayed at a time, instead of showing errors for all fields simultaneously.

Best for

  • Off (default): Show errors for all fields at once, so the user can see everything that needs to be fixed in one view
  • On: Display errors one by one, avoiding overwhelming the user with too much error information at once

Next Steps

Built with VitePress