What is this form?
This is a schema-driven form rendered by zddc-server. Every
<name>.form.yaml file in the archive becomes an
editable form at <path>/<name>.form.html.
Submissions are saved as <name>/<id>.yaml
files alongside the schema, and re-render with their data filled in
when revisited.
Filling in the form
- Required fields
- Marked with an asterisk in their label. Submitting with a
required field empty re-renders the form with an inline error.
- Validation
- Server-side via JSON Schema 2020-12 (subset). Client-side
hints (
required, min, max,
pattern) are added where the schema specifies them.
- Save
- POSTs to the same URL the form was loaded from. On success the
form closes and returns to the listing you opened it from, scrolled
to this record. On failure the form re-renders with errors inline at
each invalid field.
- Cancel
- Closes the form without writing anything, back to the same
place. Prompts first if you have unsaved changes.
Editing existing submissions
Open the saved submission's URL — the form re-renders with its
current data and any errors. Submitting overwrites the same file.
History is in git via your normal commit cycle.
Header buttons
- ◐ Theme
- Cycle auto / light / dark.
- ? Help
- This panel. Press Esc to close.