2017报表自适应功能的修改说明

自2017年2月开始，对报表在电脑和手机上展现时的自适应作了统一，现在两者的自适应用法完全一样。

用法说明如下：

1、自适应js函数

reportMatchSize( rongqi, reportdiv, mode )

参数说明：

    rongqi  页面中的html容器元素(如div,td等)，报表将按此容器的尺寸进行匹配适应

    reportdiv  报表所在的div对象

    mode  自适应方式，有以下8种取值

        0   按设计尺寸展现，不用适应容器。

        1   始终用报表宽度适应容器宽度，报表高度同比例缩放

        2   始终用报表高度适应容器高度，报表宽度同比例缩放

        3   竖屏时，相当于mode=2；横屏时，相当于mode=1

        4   竖屏时，相当于mode=1；横屏时，相当于mode=2

　　    5   竖屏时，报表高和宽均分别适应容器的高和宽；横屏时，不需适应容器

　　    6   竖屏时，不需适应容器；横屏时，报表高和宽均分别适应容器的高和宽

　　    7   报表高和宽均分别适应容器的高和宽

　　横屏定义为容器宽度大于高度，竖屏定义为容器高度大于宽度。

 

函数功能：让reportdiv按照实际尺寸以指定的适应方式与容器rongqi的尺寸相匹配适应

    说明：自适应功能不适合用于固定表头的报表和折叠报表

2、如何使用

　　用户在展现报表的jsp中，写一个js函数来调用系统提供的reportMatchSize函数实现自适应功能，在页面加载完成时和窗口大小改变时调用。如系统提供的示例matchReport.jsp中那样。

　　由于在手机上当屏幕横竖方向变化时，系统要重新调用用户写的自适应函数，因此我们规定，用户写的用于手机上的自适应函数名固定名称为matchReport()，没有函数参数。

　　

3、改版后优点

　　以前的手机报表自适应功能，是固定写死的让报表与屏幕大小相适应，如果页面里除了报表以外，还有别的元素，在报表自适应以后，别的元素就会被覆盖了。这就让手机展现报表的页面不够灵活，无法添加一些用户需要的元素。修改以后，用户就可以随便添加了，比如工具条、回退按钮、参数表单(手机上屏幕较小，不建议添加参数表单)等。

　　以前电脑版自适应的适应方式参数只有三个且与手机版不统一，修改后两者完全一致了。

　　自适应功能是js实现的，因此用户完全可以在自己的jsp中调用，来灵活地添加自适应功能。比如，假如用户想在大报表展现页面，让大报表也有自适应功能，就可以参照matchReport.jsp的原理，给大报表添加此功能，也就可以在手机上展现大报表了。

4、作废

　　以前html标签中的matchScreen选项不再使用。