Skip to main content

Overview

JoyDoc provides validation for required fields, ensuring users complete necessary information before submitting forms. The validation system respects conditional logic and field visibility.

How It Works

Basic Usage

Validation Logic

  1. Hidden fields are always valid (respects conditional logic)
  2. Non-required fields are always valid
  3. Required fields with empty values are invalid
  4. Required fields with values are valid

Empty Value Detection

  • Text/Number/Dropdown: Empty if "", null, or undefined
  • Arrays (image, file, multiSelect): Empty if not array, empty array, or all items are empty strings
  • Table : Empty if field.value is an empty array

Configuring Required Fields

Set required: true on any field:

Validation Results

Status meanings:
  • 'valid': All required fields filled
  • 'invalid': One or more required fields empty
  • null: Invalid document structure

Implementation Example

Key Points

  • Hidden fields are always valid (respects conditional logic)
  • Validate on document changes using the onChange callback
  • Use visual feedback to show validation status to users
  • Debug with raw validation data when troubleshooting