on-event-update-area
当对应表单事件发生时,指定局域会自动刷新。
可包含的子标签
按顺序包含三个子标签(可以没有,但是顺序不反了。):
auto-parameters-service auto-parameters-entity parameter
包含的属性
event-type:必须,枚举类型,取值有:paginate sort-column submit, 分别表示分页,排序,提交事件。
area-id:必须,字符串,该值一般是容器的id,如<container>或者<div>标签的id属性。表示该区域要局部刷新。
area-target:必须,字符串,局部刷新的请求url。类似ajax的url参数。
例子:
<form name="ListBudgets" type="list" list-name="listIt" paginate-target="ListBudgets"
odd-row-style="alternate-row" header-row-style="header-row-2" default-table-style="basic-table hover-bar">
<actions>
<service service-name="performFind" result-map="result" result-map-list="listIt">
<field-map field-name="inputFields" from-field="parameters"/>
<field-map field-name="entityName" value="Budget"/>
<field-map field-name="orderBy" from-field="parameters.sortField"/>
<field-map field-name="viewIndex" from-field="viewIndex"/>
<field-map field-name="viewSize" from-field="viewSize"/>
</service>
</actions>
<field name="budgetId" widget-style="linktext" sort-field="true">
<hyperlink description="${budgetId}" target="EditBudget" also-hidden="false">
<parameter param-name="budgetId"/>
</hyperlink>
</field>
<field name="budgetTypeId" sort-field="true"><display-entity entity-name="BudgetType"/></field>
<field name="customTimePeriodId" sort-field="true">
<display/>
</field>
<field name="comments" sort-field="true">
<display/>
</field>
<on-event-update-area event-type="paginate" area-id="search-results" area-target="BudgetSearchResults"/>
</form>
当触发相应事件时,通过ajax访问 area-target指向的url,将访问返回的结果更新到area-id容器中。
当点击页面的下一页按钮时,上面定义的on-event-update-area标签就会生效,会触发局部刷新,并且使得form标签的paginate-target属性失效。ajax通过post方式访问componentName/control/BudgetSearchResults。
ofbiz处理请求后返回消息,这里例子是返回html片段,然后使用$("#search-results").html(resultHtml)局部刷新容器。
如果不定义on-event-update-area,则点击下一页时,会通过get方式访问paginate-target指定的url(当然如果有查询条件会自动添加到url),即componentName/control/ListBudgets,然后刷新整个页面。
sort-column和submit类型的on-event-update-area原理应该是相同的,用的最多的情况是paginate类型。