Yii框架无内置动态表单组件，需通过ActiveForm、AJAX、JavaScript与模型层协同实现字段增删、条件渲染及异步联动；关键在于前后端命名规则、数据结构与验证逻辑的一致性。
Yii 框架本身不内置“动态表单”组件，但可以通过组合 ActiveForm、AJAX、JavaScript 和模型层的灵活处理，实现字段级动态增删、条件渲染、异步联动等交互效果。关键不在“有没有”，而在“怎么搭得稳、改得清、传得准”。
动态添加/删除表单项：用 JavaScript 控制 DOM，但必须对齐后端命名规则
前端新增一个 <input>，后端要能识别它属于哪个数据项；否则 $model->load() 会直接忽略。常见错误是生成了 name="labelv3" 这类硬编码键名，而没按数组格式组织。
- 正确做法是统一用数组式 name，例如
name="items[2][key]"和name="items[2][value]"，这样$model->load(Yii::$app->request->post())才能映射到$model->items[2]['key'] - 删除时别只删 DOM，记得同步清理 JS 中维护的索引计数器（比如全局
window.nextIndex），否则新增后 ID 冲突或跳号 - 服务端验证前先检查
isset($_POST['items'])，空数组或缺失字段要提前兜底，避免foreach(null)报错
下拉联动（如省→市）：用 AJAX + action 返回 JSON，别在前端硬塞全部数据
把所有省市区数据一次性加载到 JS 变量里，看似省请求，实则拖慢首屏、难维护、无法实时更新。Yii 的标准解法是后端提供轻量接口，前端按需拉取。
- 控制器中定义 action，如
actionCities($provinceId)，返回Json::encode($cities)，并显式设Yii::$app->response->format = Response::FORMAT_JSON - 前端用 jQuery 的
$.get()请求该地址，成功后清空原<select>并用append()插入<option>，注意设disabled状态防误选 - 务必加 loading 状态和错误提示——网络失败或返回空数组时，用户需要明确反馈，而不是看着下拉框发呆
动态字段绑定模型属性：绕过 ActiveRecord 硬约束，用 DynamicModel 或扩展 rules()
当表单字段数量/结构完全由配置驱动（比如后台可配置的问卷），不能靠写死 public $title, $content 属性。这时候 DynamicModel 是更干净的选择。
-
$model = DynamicModel::validateData($_POST, ['field1', 'field2'])->addRule(['field1'], 'required')，可临时建模、校验、获取错误 - 若仍想复用 ActiveRecord，可在模型中重写
rules()，根据运行时参数动态返回规则数组，但要注意缓存失效问题（getRules()不会自动重算） - 字段名若含点号或方括号（如
profile[address][city]），需确保attributeLabels()能正确映射，否则$form->label()显示空白
提交时的数据结构对齐：重点检查 $_POST 和模型属性的嵌套层级
最常踩的坑不是 JS 写错了，而是后端接收到的数组结构和模型期望的不一致，导致 load() 失败却无报错，数据静默丢失。
- 用
var_dump(Yii::$app->request->post())在 action 开头打印原始输入，确认 key 名、层级、空值表示方式（''还是null） - 如果前端传的是
items[0][name]，模型中对应属性应为public $items = []，且rules()里写['items', 'each', 'rule' => ['required']] - 多维数组提交后，
$model->validate()默认只校验顶层属性；深层字段需手动触发$model->items[0]->validate()或用scenarios显式启用嵌套验证
动态表单真正的复杂点从来不在“怎么加一个输入框”，而在于“怎么让前后端对同一份结构语义达成共识”。字段名、嵌套层级、空值含义、错误定位路径——这些细节一旦错位，调试成本远高于初始开发。建议每次新增动态逻辑，都同步更新一份简易的 POST 结构文档片段，贴在对应 action 注释里。
