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

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有两种调用形式，推荐的函数定义如下所示：

其中三个参数的意义：

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

一个典型的示例：

F.doPostBack('/Other/FormAjaxComplete/onForm1Submit', 'Form1', {
    key1: 'value1',
    key2: {
        'sub1': 'sub-value1',
        'sub2': 'sub-value2'
    }
});

在这个例子中：

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

完整的 F.doPostBack 函数定义：

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

再来看下一个示例：

F.doPostBack({
    url: '/Other/FormAjaxComplete/onForm1Submit',
    fields: 'Form1',
    params: {
        key1: 'value1',
        key2: {
            'sub1': 'sub-value1',
            'sub2': 'sub-value2'
        }
    }
});

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

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

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

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

官网示例已更新：

• 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/