ofbiz局部刷新on-event-update-area（如分页等）

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