我们在开发中,很难会遇见不提交表单的情况。常用的apex:commandButton,apex:commandLink,apex:actionFunction,apex:actionSupport。他们进行操作的时候,会将整个表单提交。但是我们很多时候的需求,只是希望提交一部分内容,而不是全部。这个时候,我们就需要用到apex:actionRegion.
一.apex:actionRegion
apex:actionRegion为当一个ajax请求生成的时候,可以通过它来区分哪部分区域/组件可以应该被Force.com Service处理,只有在actionRegion内部的组件元素被处理。
apex:actionRegion用于apex:form中涉及到表单提交指定区域块或者组件的内容,如果一个表单提交请求需要提交整个页面,则不必使用apex:actionRegion。
apex:actionRegion尽管可以用于ajax请求的时候,指定区域提交,但是却无法定义请求完成后的reRender区域,reRender操作仍然在相关的控件的reRender部分来操作,即apex:actionRegion作用只在于提交表单时可以指定区域内容来提交。
二.apex:actionSupport
actionSupport作用为当一个特定的事件被触发,比如单击,失去焦点,鼠标移入等操作被触发时,允许组件进行异步的刷新功能,常用场景为联动,失去焦点后校验在数据库中是否唯一等。
actionSupport和actionFunction在功能上很相像,不过有几点小区别:
1.actionSupport是直接被其他的元素调用,actionFunction可以通过js调用,你可以在js中进行一些简单的处理,也可以直接被其他元素调用;
2.actionSupport仅允许在单一的事件上调用action的method,actionFunction可以被多个事件调用。
demo举例:
1.TestActionSupportController:设置一个testOptions变量,初始值是xxx,当调用changeOptions后变成yyy
public with sharing class TestActionSupportController { public Account acc{get;set;} public String testListValue{get;set;} public List<SelectOption> testOptions {
get {
if(testOptions == null) {
testOptions = new List<SelectOption>();
testOptions.add(new SelectOption('xxx','xxx'));
}
return testOptions;
}set;
} public void changeOptions() {
testOptions = new List<SelectOption>();
testOptions.add(new SelectOption('yyy','yyy'));
}
}
2.TestActionSupport.page:显示一个必填输入框以及一个下拉列表,下拉列表控制着另外一个下拉列表的显示。
<apex:page controller="TestActionSupportController">
<apex:form id="theForm">
<apex:inputField value="{!acc.Name}" required="true" style="padding-bottom: 5px;"/>
<br/>
<apex:outputPanel id="industryPanel" style="padding-bottom: 5px;">
<apex:inputField value="{!acc.Industry}"/>
<apex:actionSupport event="onchange" action="{!changeOptions}" reRender="testSelectList"/>
</apex:outputPanel>
<apex:selectList value="{!testListValue}" id="testSelectList" style="margin-left: 5px;">
<apex:selectOptions value="{!testOptions}">
</apex:selectOptions>
</apex:selectList>
</apex:form>
</apex:page>
显示效果如下:
其实上面的vf代码是有问题的,当选择了下拉框,右侧的下拉框的值也不修改成yyy,原因是这样的:
当actionSupport执行时,会提交整个form表单,因为上面有一个required的字段,所以导致提交表单失败,没有走action对应的后台的的method,所以没有更新下拉框里面的值,这种情况有两种可以修改的方式,1是将actionSuuport设置成immediate="true"方式,可以忽略表单的validation,第二种是使用actionRegion方式,这样from表单提交时只提交actionRegion内的数据,从而避免了上面的尴尬,使用actionRegion方式修改如下:
<apex:page controller="TestActionSupportController">
<apex:form id="theForm">
<apex:inputField value="{!acc.Name}" required="true" style="padding-bottom: 5px;"/>
<br/>
<apex:actionRegion>
<apex:outputPanel id="industryPanel" style="padding-bottom: 5px;">
<apex:inputField value="{!acc.Industry}"/>
<apex:actionSupport event="onchange" action="{!changeOptions}" reRender="testSelectList"/>
</apex:outputPanel>
<apex:selectList value="{!testListValue}" id="testSelectList" style="margin-left: 5px;">
<apex:selectOptions value="{!testOptions}">
</apex:selectOptions>
</apex:selectList>
</apex:actionRegion>
</apex:form>
</apex:page>
显示效果:当更改下拉框的之,会修改成yyy
总结:使用actionRegion和actionSupport可以更加灵活的提交表单,提升表单提交的性能。内容描述错误的地方欢迎指出,有问题欢迎留言。