核心限制在于浏览器原生不支持直接渲染JSON Schema为可编辑表单，必须依赖JavaScript库（如vanilla-jsonschema-form）在运行时解析schema、构造DOM并绑定验证逻辑。
JSON Schema 表单生成的核心限制在哪
浏览器原生不支持直接把 JSON Schema 渲染成可编辑表单。你看到的“动态生成”，全是靠 JavaScript 库在运行时解析 schema、构造 DOM、绑定验证逻辑——没有现成的 HTML 标签或属性能跳过这步。
这意味着：纯静态 HTML 文件 + 一段 script 标签，是做不到的；必须引入一个运行时解析器，比如 react-jsonschema-form、jsonforms 或轻量级的 vanilla-jsonschema-form。
常见误区是试图用 <form> + data-schema 自定义属性硬塞 schema，结果发现 submit 事件里拿不到结构化数据，或日期/数组字段根本无法渲染。
用 vanilla-jsonschema-form 快速跑通最小可行流程
它不依赖 React/Vue，适合嵌入已有页面，且支持基本类型（string、number、boolean、object、array）和常用校验（required、minLength、maximum）。
DMap GL地图JSAPI（dmapgl）开发指南。用于编写、审查、调试 DMap 地图 API 代码，涵盖地图初始化、覆盖物渲染、图层管理、事件处理、控件交互等任务。当用户提及 dmap、dmapgl、jsapi‑gl 或相关地图开发需求时自动触发。
立即学习“前端免费学习笔记（深入）”；
- 通过 npm 安装：
npm install vanilla-jsonschema-form，或直接用 CDN：https://cdn.jsdelivr.net/npm/vanilla-jsonschema-form@2.4.0/dist/vanilla-jsonschema-form.min.js - HTML 中预留容器：
<div id="form-root"></div> - JS 中调用：
renderForm(schema, uiSchema, { container: '#form-root' })，其中uiSchema可选，用于控制字段顺序、隐藏、分组等 - 获取值用
getFormData()，不是监听submit—— 它默认不生成传统<form>标签，而是用div+input模拟
required 字段不报错？检查 validate 是否启用
很多用户写了 "required": ["email"]，但留空提交却没提示。这是因为 vanilla-jsonschema-form 默认只做 UI 渲染，不自动触发校验。
- 必须显式调用
validate(formData)，它返回一个{ errors: [...], valid: boolean }对象 - 错误信息不会自动插入 DOM，得自己遍历
errors数组，按property（如"#/email"）定位对应输入框并加红边/提示文字 - 如果想提交时统一校验，别绑定原生
click，改用它提供的onSubmit钩子：renderForm(schema, {}, { onSubmit: (e) => { const res = validate(e.formData); ... } })
数组字段（type: "array"）为什么只显示一个输入框
因为默认不启用数组增删功能。schema 里写 "type": "array", "items": { "type": "string" }，只是声明结构，UI 层需要额外配置才能出现“+”按钮。
- 必须在
uiSchema中为该字段指定："ui:options": { "addable": true, "removable": true } - 注意：某些版本对嵌套
array（比如array of objects）支持不稳定，建议先用简单string[]验证流程 - 生成的每个子项 DOM 会带
data-index属性，方便 JS 定位，但删除后索引不会重排，getFormData()返回的仍是正确顺序数组
真正麻烦的是自定义 widget（比如富文本、地图坐标选择器），那得自己写 registerWidget，而且要处理好 schema 中 format 和 custom 字段的映射关系——这部分没封装，容易卡住。
