【新特性速递】F.doPostBack的说明文档

sanshi

FineUIPro/Mvc/Core的下个版本（v6.1.0），我们对客户端JS函数 F.doPostBack 进行了增强，并增加说明文档。




如果你还没有查阅过FineUI的客户端文档，可以收藏下这个在线链接：https://fineui.com/js/api/



F.doPostBack用于自定义回发，一般用于FineUIMvc/Core/JS版本，而WebForms版本是不适用的：

• FineUIPro：请使用 __doPostBack 函数回发，参考示例：https://pro.fineui.com/#/other/custom_postback.aspx
• FineUIMvc/Core/JS：可以使用 F.doPostBack 自定义回发，参考示例：https://core.fineui.com/#/Other/CustomPostback
  

F.doPostBack有两种调用形式，推荐的函数定义如下所示：

F.doPostBack(url, fields, params)
其中三个参数的意义：

• url：发送请求的地址
• fields：【可选】发送到服务器的表单字段数据，以逗号分隔多个表单字段（如果是容器，则查找容器内的所有表单字段）
• params：【可选】发送到服务器的数据
  

一个典型的示例：

1. F.doPostBack('/Other/FormAjaxComplete/onForm1Submit', 'Form1', {
   
2.     key1: 'value1',
   
3.     key2: {
   
4.         'sub1': 'sub-value1',
   
5.         'sub2': 'sub-value2'
   
6.     }
   
7. });

复制代码

在这个例子中：

• 请求会被回发到：/Other/FormAjaxComplete/onForm1Submit
• 发送请求时，FineUI会查找名为Form1控件下所有的表单字段，并将这些表单字段的值放在请求正文中
• 除了Form1容器内的表单数据，还会把 key1, key2 的值放到请求正文中回发到服务器
  

完整的 F.doPostBack 函数定义：

F.doPostBack(options)
这里的 options 可以对请求进行一个细微的控制，但是并不常用，具体的参数列表可以看下在线文档。

再来看下一个示例：

1. F.doPostBack({
   
2.     url: '/Other/FormAjaxComplete/onForm1Submit',
   
3.     fields: 'Form1',
   
4.     params: {
   
5.         key1: 'value1',
   
6.         key2: {
   
7.             'sub1': 'sub-value1',
   
8.             'sub2': 'sub-value2'
   
9.         }
   
10.     }
    
11. });

复制代码

这个示例实现的功能和前面的代码其实是一模一样的。



但是在这种调用形式下，我们可以加入更多的控制，比如在AJAX结束后执行一个回调。

下面这个官网示例正好作为演示：https://core.fineui.com/#/Other/FormAjaxComplete

1. // 自定义回发，设置完成时回调complete
   
2. F.doPostBack({
   
3.     url: '@Url.Action("onForm1Submit")',
   
4.     fields: 'Form1',
   
5.     // 不显示页面加载动画
   
6.     enableAjaxLoading: false,
   
7.     complete: function (data) {
   
8.         // AJAX回发结束时隐藏面板加载动画
   
9.         form1.hideLoading();
   
10.     }
    
11. });

复制代码

官网示例已更新：

• FineUIPro：https://pro.fineui.com/
• FineUIMvc：https://mvc.fineui.com/
• FineUICore：https://core.fineui.com/
• FineUICore （Razor Pages & Tag Helpers）：https://pages.fineui.com/
• F.js：https://js.fineui.com/
  

现在加入【三石和他的朋友们】星球，下载FineUIPro/Mvc/Core（基础版）：https://fineui.com/fans/