反馈已提交

网络繁忙

当前为10.0版本文档,只有最新版本的文档支持在线编辑修改,如果想创建/编辑文档,请移步至 最新版帮助文档

跑马灯简介

  • 文档创建者:RosieY
  • 历史版本:19
  • 最近更新:RosieY 于 2022-03-30
  • 1. 概述

    1.1 版本

    报表服务器版本JAR包日期功能变动
    10.0.192021/9/6新增跑马灯 JS 接口,单行代码即可实现跑马灯
    10.0.192021/11/30跑马灯接口的单位改为s

    1.2 应用场景

    滚动的消息文本或者表格内容一般被称为跑马灯,如下图所示。跑马灯有比较广泛的应用场景,尤其是在看板和大屏中:

    • 某个区域内容较多但布局有限,就可以通过跑马灯的形式呈现

    • 表格内容较多,可以通过表格滚动将内容全部展示

    • 新闻内容展示时,多条消息、字幕滚动

    • 监控场景中,滚动消息提醒

    • 大型展示屏中,图文滚动实现动态效果

    1615539938596750.gif

    1.3 功能介绍

    通过跑马灯接口实现效果,将  JS 接口代码添加在报表事件中即可实现。

    注:10.0.19 之前的版本不支持使用跑马灯接口,如需实现跑马灯效果请参考本文第 4 章 。

    2. 接口介绍

    注1:以下接口适用于 10.0.19 及之后的版本。

    注2:用以下接口实现的跑马灯效果,不支持通过「决策报表内报表块刷新插件」实现刷新。

    2.1 开启跑马灯

    方法startMarquee(opt)开启跑马灯效果
            参数opt: {
    offset: number,
    interval: number,

    stopOnHover: boolean,

    to: string

    }

    滚动效果属性,json 格式

    offset:每次滚动的距离,默认为 5 px

    interval:间隔时长,默认为 0.1 s,自行设置单位为 s

    注:JAR包日期为2021/11/29 及之前,单位为 ms 。

    stopOnHover:鼠标悬停时是否暂停,默认为 true

    • true:暂停

    • false:不暂停

    to:滚动的方向,支持向上和向左,默认向上

    • 'top':向上滚动

    • 'left':向左滚动

         返回值void
            示例

    将获取到的报表块对象定义为 report,实现默认的跑马灯效果(每 0.1s 滚动 5 px,鼠标悬停时暂停):

    report.startMarquee();

    实现每 0.3s 滚动 2 px,鼠标悬停时不暂停:

    report.startMarquee({        
    offset: 2,        
    interval: 0.3,        
    stopOnHover:false    
    });

    普通报表中添加跑默认的跑马灯效果:

    _g().startMarquee();

    决策报表中给 report0 报表块添加默认的跑马灯效果:

    注:决策报表中使用时,建议添加一个延迟函数。

    setTimeout(function(){
         _g().getWidgetByName('report0').startMarquee()
    }, 500);
      应用示例

    报表块实现跑马灯效果,鼠标悬浮时停止滚动:

    2021-08-25_16-46-53.gif

         移动端不支持移动端

    2.2 关闭跑马灯

    方法stopMarquee()关闭跑马灯效果
         参数-

    -

       返回值void
         示例

    将获取到的报表块对象定义为 report,关闭通过 startMarquee() 设置的跑马灯效果:

    report.stopMarquee();

    普通报表中: 

    _g().stopMarquee();

    决策报表中:

    _g().getWidgetByName('report0').stopMarquee();
      应用示例

    报表块实现跑马灯效果,点击「关闭」按钮取消跑马灯效果:

    2021-08-27_14-30-18.gif

       移动端不支持移动端

    3. 示例

    3.1 准备模板

    新建模板,设计一个简单表格。如下图所示:

    点击可下载模板:普通表格.cpt

    3.2 添加事件

    3.2.1 开启跑马灯

    打开模板,点击「模板>模板Web属性>分页预览设置」,选择「为该模板单独设置」,在「事件设置」位置添加一个「加载结束」事件,实现预览报表时呈现跑马灯效果。如下图所示:

    JavaScript 代码如下:

    注:如需修改滚动速度、滚动方向,可参考 2.1 节接口内容修改。

    _g().startMarquee();

    3.2.2 关闭跑马灯

    1)打开模板,点击「参数面板」,拖入一个「按钮控件」,修改名称为「跑马灯关」。如下图所示:

    2)选中「跑马灯关」按钮,点击「控件设置>事件」,在「添加事件」处为按钮添加一个「点击」事件,实现点击按钮时关闭跑马灯。如下图所示:

    JavaScript 代码如下:

    _g().stopMarquee();

    3)点击「参数面板」,取消勾选「点击查询前不显示报表内容」。如下图所示:

    3.3 预览效果

    保存模板,点击「分页预览」,效果如下图所示:

    注:不支持移动端。

    2021-09-23_14-17-08.gif

    3.4 模板下载

    已完成模板可参见:%FR_HOME%\webapps\webroot\WEB-INF\reportlets\doc\JS\分页预览JS实例\JS 实现跑马灯效果.cpt

    点击下载模板:JS 实现跑马灯效果.cpt

    4. 其他方法

    其他实现方法可参考如下表格内容:

    方法介绍效果图示适用类型支持的方向

    实现思路:

    无需代码,安装「滚动消息控件插件」就可以简单又方便地实现滚动字幕的效果。

    参考文档:

    滚动消息控件插件


    23.gif
    决策报表

    向左

    向右

    向下

    向上

    实现思路:

    单元格中添加 html 代码,显示 html 内容实现文字滚动。可竖屏滚动、横屏滚动、不规则横屏滚动,修改代码即可实现。

    参考文档:

    以HTML实现消息滚动

    24.gif25.gif

    普通报表决策报表

    向左

    向右

    向下

    向上

    实现思路:

    普通报表中,添加 JS 使得单元格内容滚动,滚动到最后一行后跳转到第一行继续滚动;鼠标悬停时停止滚动。

    参考文档:

    JS实现自动滚屏/跑马灯效果

    22.gif
    普通报表向上

    实现思路:

    决策报表中,给报表块添加 JS 实现单元格内容滚动,滚动到最后一行后跳转到第一行继续滚动;鼠标悬停时停止滚动。

    参考文档:

    JS实现决策报表中滚屏/跑马灯效果

    20.gif
    决策报表向上

    实现思路:

    单元格中添加 html 代码,再配合 JS 实现滚动效果。滚动到最后一行后接上第一行内容,实现首尾相接的滚动效果。

    参考文档:

    JS实现首尾相接的跑马灯

    21.gif
    普通报表决策报表向上


    附件列表


    主题: 报表应用
    • 有帮助
    • 没帮助
    • 只是浏览

    售前咨询电话

    400-811-8890转1

    在线技术支持

    请前往「服务平台」,选择「在线支持」

    热线电话:400-811-8890转2

    总裁办24H投诉

    热线电话:173-1278-1526