依赖字段显隐由前端JavaScript控制，ThinkPHP仅传递规则JSON；需统一配置依赖逻辑、动态加载子字段、前后端验证条件一致。
依赖字段显隐的核心逻辑是前端控制，不是ThinkPHP后端直接渲染
ThinkPHP本身不提供“根据某字段值自动显示/隐藏其他字段”的内置能力——它只负责把数据吐给前端，显隐行为必须由 JavaScript 在浏览器里完成。后端能做的，是把字段依赖关系、初始状态、可选值等元信息（比如 JSON 格式）传给模板，让前端有据可依。
常见错误是试图在控制器里用 if-else 拼 HTML 或在模板中写大量 {if $data.type eq 'user'}...{/if} 嵌套判断，结果一加新类型就改崩模板，维护成本极高。
推荐做法：
- 在数据库或配置中定义字段依赖规则（例如：
field_b的显隐取决于field_a的值是否为'advanced'） - 控制器中将规则以数组形式赋给模板：
$this->assign('rules', json_encode($deps)); - 模板中用
<script>初始化规则，绑定change事件监听依赖字段 - 避免直接操作
display:none，优先用 CSS 类（如.hidden）配合 JS 切换，利于样式复用和过渡动画
如何用 JSON 规则驱动表单显隐（ThinkPHP + 原生 JS 示例）
假设有一个表单：选择「类型」后，仅当类型为 'custom' 时才显示「自定义标题」字段。
立即学习“PHP免费学习笔记（深入）”；
控制器中准备规则：
$deps = [
'title_custom' => [
'depends_on' => 'type',
'show_when' => ['custom'],
'hide_by_default' => true
]
];
模板中嵌入并初始化：
<script>
const fieldRules = <?php echo $rules ?>;
document.addEventListener('DOMContentLoaded', () => {
Object.keys(fieldRules).forEach(fieldId => {
const rule = fieldRules[fieldId];
const target = document.getElementById(fieldId);
const trigger = document.getElementById(rule.depends_on);
if (!target || !trigger) return;
const toggle = () => {
const show = rule.show_when.includes(trigger.value);
target.classList.toggle('hidden', !show);
};
trigger.addEventListener('change', toggle);
toggle(); // 初始化状态
});
});
</script>
注意点：
-
trigger.value是字符串，show_when必须是字符串数组，别写成1或true - 如果依赖字段是复选框（
checkbox）或多选下拉（select[multiple]），需改用trigger.checked或遍历trigger.selectedOptions - ThinkPHP 模板里输出 JSON 一定要用
htmlspecialchars防 XSS，建议用json_encode($deps, JSON_UNESCAPED_UNICODE | JSON_HEX_TAG)后再raw输出
多级联动与异步加载字段的边界处理
当出现「省→市→区」三级联动，或「选择产品后动态加载其规格字段」这类场景，不能全靠前端静态规则。后端必须提供接口返回子级字段定义，否则字段选项或校验规则会缺失。
ThinkPHP 中应提供一个统一接口，例如：
GET /api/form/fields?parent=product_id&value=123
返回示例：
{
"sku": {"type": "text", "label": "SKU", "required": true},
"weight": {"type": "number", "label": "重量(g)", "default": 100}
}
关键注意事项：
- 接口必须校验
parent字段是否属于当前表单合法字段，防止参数注入（如传parent=delete_from_user） - 返回的字段结构要和主表单一致，方便前端统一渲染（推荐用 ThinkPHP 的
FormBuilder或自定义模板片段） - 不要在 JS 里拼 DOM，用
innerHTML插入服务端返回的 HTML 片段——这会导致 XSS 和事件绑定失效；应解析 JSON 后用document.createElement动态生成 - 首次加载时若依赖字段有默认值（如编辑页回显），需在 DOM 加载完成后主动触发一次
change事件，否则子字段不显示
验证规则也要随显隐同步，否则后端校验会报错
前端隐藏字段 ≠ 后端忽略校验。用户可能用 DevTools 手动显示并提交非法值，或绕过 JS 直接 POST 数据。ThinkPHP 的 validate 必须支持条件验证。
正确写法是用验证场景（scene）或闭包验证：
$validate = [
'title_custom' => ['require' => function($value, $data) {
return $data['type'] === 'custom' && !empty($value);
}, 'max' => 50]
];
或者更清晰的场景方式：
$rule = [
['type', 'in:basic,custom', '类型不合法'],
['title_custom', 'require', '自定义标题必填', 'function', 'type===custom'],
['title_custom', 'max:50', '标题不能超过50字', 'function', 'type===custom']
];
容易被忽略的点：
- 如果字段是数组（如
tags[]），验证规则里的require不会自动识别空数组，需额外判断!empty($data['tags']) - 使用
scene时，调用validate($rule, 'edit')必须确保$data包含所有依赖字段（包括未提交的隐藏字段），否则条件判断失败 - 前后端依赖逻辑必须严格一致：前端显示字段的条件，和后端验证该字段是否必填的条件，代码必须来源同一份配置，避免出现“前端没显示却要求必填”的体验断层
最麻烦的不是写逻辑，而是保持前后端依赖判断的一致性——建议把依赖规则抽成独立配置文件或数据库表，由 PHP 和 JS 共同读取解析，而不是各自硬编码一份。
