必须手动指定字段路径并严格遵循命名规范:字段名仅限英文小写字母和下划线,绑定表达式须以$record.开头,关联字段名须与数据模型中定义完全一致,新增字段需点击「同步结构」。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

要在函子Zion中让自定义组件准确绑定到数据表的特定字段,必须绕过“拖拽即生效”的直觉误区——Zion不会自动猜测你的意图,字段名拼写差一个字母、类型不匹配、或未启用字段可见性,都会导致组件显示空值或报错。
确认字段已在数据模型中正确定义
进入「数据模型」→「编辑表」→ 找到目标表,检查你要绑定的字段是否真实存在且状态为启用。特别注意:字段名不能含空格、中文或特殊符号,【必须严格使用英文小写字母+下划线命名,如 user_phone、order_status】。
如果该字段是后来新增的,点击右上角「同步结构」按钮,否则新字段不会出现在组件的数据源下拉列表中。
在组件属性面板中手动指定字段路径
选中画布上的组件(如文本组件、输入框、开关等)→ 打开右侧「属性检查器」→ 找到「数据绑定」或「值」字段 → 点击右侧「fx」图标或「绑定表达式」开关。
此时不要直接输入字段名。点击弹出框中的「选择字段」按钮,在树形结构里逐级展开:数据源(如 users)→ 记录(当前上下文通常是单条记录)→ 目标字段(如 email)。这一步会自动生成标准路径表达式:$record.email。
若手动输入,请务必以 $record. 开头,后面紧跟字段名;漏掉 $record. 将导致取值为空,且无任何报错提示。
处理一对多/多对多关联字段的绑定
方法一:用列表组件展示关联子项
放入「列表」组件 → 数据源选择关联关系(如 orders 关联到 users 表的 orders 字段)→ 进入列表子项模板 → 对子项内的文本组件执行上一节的 $record.xxx 绑定,此时 $record 指向的是 orders 表的每一条记录。
方法二:用聚合函数提取单值
例如在用户详情页显示“订单总数”,文本组件绑定表达式写为:$record.orders.length。注意:orders 是关联字段名,必须与数据模型中定义的关联字段名完全一致,大小写敏感。
【关联字段名≠目标表名】:比如你建了 users 表和 orders 表,并在 users 表中添加了一个「一对多」字段,命名为 my_orders,那么绑定时只能用 $record.my_orders,而不是 $record.orders。
验证绑定是否生效
第一步:保存当前页面并点击右上角「预览」。
第二步:在预览页打开浏览器开发者工具(F12),切换到 Console 标签页。
第三步:操作页面(如切换列表项、点击编辑按钮),观察是否有类似 “Failed to resolve field: $record.phone” 的警告。
没有警告 ≠ 绑定成功。请人工核对三点:① 预览时数据源是否已加载(看网络请求 tab 是否有 200 响应);② 当前上下文是否为单记录(列表项内组件 vs 页面根组件);③ 字段值本身是否为空(后台查数据库确认)。
这一步做完,组件就真正和字段对上了。











