FineUI 官方论坛

标题: 【新特性速递】F.doPostBack的说明文档 [打印本页]

作者: sanshi 时间: 2019-12-25 09:57
标题: 【新特性速递】F.doPostBack的说明文档

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

如果你还没有查阅过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：【可选】发送到服务器的数据

一个典型的示例：

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

复制代码

在这个例子中：

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

完整的 F.doPostBack 函数定义：

F.doPostBack(options)
这里的 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/

欢迎光临 FineUI 官方论坛 (https://www.fineui.com/BBS/)