onFormat is not a function

[HerCats]

组件

<form-picker
label="水果"
arrow
name="fruit"
options="{{fruitList}}"
bindref="handleRef"

<form-date-picker
label="出生日期"
arrow
name="birthday"
bindref="handleRef"

<form-range-picker
label="时间范围"
arrow
name="range"
bindref="handleRef"

这几个组件都有相同报错提示

基础库版本

微信开发者工具版本：3.8.11

APP

微信小程序

组件库版本

"antd-mini": "^3.2.2",

预期行为

组件正常运行 控制台无 onFormat is not a function报错

复现步骤

https://ant-design-mini.antgroup.com/components/form

我使用的是Form表单中的-->代码示例-->基本使用

代码原样复制到一个新开的微信小程序项目

控制台报错如下

[dosubot]

Hi @AngelBeatsOnly! I'm Dosu and I’m helping the ant-design-mini team.

这个报错的根本原因是 WeChat 小程序下数据绑定的细节问题：<form-picker>、<form-date-picker>、<form-range-picker> 这些组件的模板里，onFormat 属性会尝试绑定到 handleFormat，但如果 handleFormat 没有正确挂载到组件 data 上，就会把字符串 'handleFormat' 传给底层 picker，而不是函数，导致运行时报 onFormat is not a function 错误。

在源码里，onFormat 是可选的，组件内部也做了存在性判断，没传的话会用默认格式化函数，不会报错。但如果模板传递的是字符串 'handleFormat'，就会触发你遇到的报错（因为字符串不是函数）参考源码。

解决方法：在你的页面/组件的 data 里显式加一个空函数 handleFormat，比如：

Page({
  data: {
    fruitList: [/* ... */],
    handleFormat: () => {}
  },
  // 其他逻辑...
})

或者在组件初始化时确保 handleFormat 已经被绑定（比如在 attached 生命周期里）。这样就不会把字符串传下去，报错也会消失。

这个问题主要是 WeChat 小程序的数据绑定机制和 antd-mini 组件模板的兼容性细节导致的，Alipay 小程序一般不会遇到。官方文档和 issues 里目前没有专门提到这个坑。

如果你需要自定义格式化显示，可以把 handleFormat 实现成你想要的格式化函数，否则直接用空函数即可。

To reply, just mention @dosu.

---

Docs are dead. Just use Dosu.

[CrazyForCry]

Hi @AngelBeatsOnly! I'm Dosu and I’m helping the ant-design-mini team.你好！我是 Dosu，正在帮蚂蚁设计迷你团队。

这个报错的根本原因是 WeChat 小程序下数据绑定的细节问题：<form-picker>、<form-date-picker>、<form-range-picker> 这些组件的模板里，onFormat 属性会尝试绑定到 handleFormat，但如果 handleFormat 没有正确挂载到组件 data 上，就会把字符串 'handleFormat' 传给底层 picker，而不是函数，导致运行时报 onFormat is not a function 错误。

在源码里，onFormat 是可选的，组件内部也做了存在性判断，没传的话会用默认格式化函数，不会报错。但如果模板传递的是字符串 'handleFormat'，就会触发你遇到的报错（因为字符串不是函数）参考源码。

解决方法：在你的页面/组件的 data 里显式加一个空函数 handleFormat，比如：

Page({
data: {
fruitList: [/* ... */],
handleFormat: () => {}
},
// 其他逻辑...
})
或者在组件初始化时确保 handleFormat 已经被绑定（比如在 attached 生命周期里）。这样就不会把字符串传下去，报错也会消失。

这个问题主要是 WeChat 小程序的数据绑定机制和 antd-mini 组件模板的兼容性细节导致的，Alipay 小程序一般不会遇到。官方文档和 issues 里目前没有专门提到这个坑。

如果你需要自定义格式化显示，可以把 handleFormat 实现成你想要的格式化函数，否则直接用空函数即可。

To reply, just mention @dosu.回复时，只需提及 @dosu。

How did I do? Good | Irrelevant | Incorrect | Verbose | Hallucination | Report 🐛 | Other   我表现得怎么样？ 很好 | 无关紧要 | 错误 | 冗长 | 幻觉 | 报告 🐛 | 其他     

我目前使用的antd-mini": "^3.4.3"， 微信开发者工具版本: macOs 2.01.2510250 darwin-arm64
按照您的方案依然还是出现上述提出的报错，不知是否有详细的修复方案