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

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

 

 【新特性速递】F.doPostBack的说明文档_第1张图片

 

如果你还没有查阅过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'
    }
});

在这个例子中:

  1. 请求会被回发到:/Other/FormAjaxComplete/onForm1Submit
  2. 发送请求时,FineUI会查找名为Form1控件下所有的表单字段,并将这些表单字段的值放在请求正文中
  3. 除了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/

 

你可能感兴趣的:(【新特性速递】F.doPostBack的说明文档)