有时用户会在我们设想的顺序之前点击确定。不管是需要在保存数据前先进行验证,还是要抓一些其他的信息,或者是创建一个通知让用户知道一些事情,都可以利用SharePoint的一个内置功能,该功能允许我们在保存信息被提交前截取确认按钮的点击事件。
事实上,我们甚至可以在标准的默认列表表单(类似NewItem.aspx等等)上使用该功能,除非你根本就不打算进入编辑状态。
PreSaveAction()
在SharePoint里默认的保存(或确定)按钮会在进行其他操作前首先调用PreSaveAction(),它是个空函数。所以,我们可以利用它来在列表项保存之前做些事情,甚至如果需要的话可以阻止其保存。
只需简单的将PreSaveAction()Javascript函数添加到页面上的一个内容编辑器WebPart (简称CEWP)里即可。如下:
<script language="javascript" type="text/javascript">
function PreSaveAction() {
// 做一些事情 - 在接下来的博文中,你将看到建议在这里做的事
return true; //如果事情进展顺利…
//或
return false; // 如果事情进行的有问题…
}
</script>
在DVWP中使用PreSaveAction()
如果你一直关注扩展DVWP系列的话,一定很关心这个功能在DVWP中该怎么使用。在一个DVWP的列表表单操作中,不会调用PreSaveAction(),但是我们可以让它去调用,同样也很简单。
若要从一个表单操作链接中调用PreSaveAction(),只需在GenFireServerEvent调用前添加一个到它调用即可。
即,从原来的:
<a href="javascript: {ddwrt:GenFireServerEvent('__commit')}">保存文件</a>
变成:
<a href="javascript: if(PreSaveAction()) {ddwrt:GenFireServerEvent('__commit')}">保存文件</a>
通过把该调用放置在if条件里,我们可以确保当我们不想后面的部分运行时就不会运行。也就是说,我们实现了与开箱即用的确定按钮同样的功能。
运行效果
最极端的一个实验,如果将PreSaveAction()写成下面这样:
function PreSaveAction()
{
alert("不允许修改!");
return false;
}
就可以从页面层次阻止用户对列表数据的修改了。以下是在EditForm.aspx中点击“确定”按钮的运行效果:
在数据视图Web部件中点击“保存文件”链接时的运行效果:
下一篇中:我们将讨论如果在DVWP的列表表单操作中使用工作流。
参考资料
SharePoint: Extending the DVWP – Part 5: Doing Stuff Before Save on Submit – PreSaveAction()