ofbiz局部刷新on-event-update-area(如分页等)

来源:互联网 发布:韩家炜 数据挖掘 pdf 编辑:程序博客网 时间:2024/06/01 21:27

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类型。