HTML5 的 JS 接口

妖狐艹你老母 2021-12-16 07:51 212阅读 0赞

## 1. 移动端 H5 哪些地方支持 JS ##

注：目前文档内容还是 FR9.0 的，待 10.0 适配好之后再进行更新。

<table style="width:600px;"> 
 <tbody> 
  <tr> 
   <th>&nbsp; web事件</th> 
   <th>分页预览 &nbsp;</th> 
  </tr> 
  <tr> 
   <td>&nbsp; 加载起始事件</td> 
   <td>&nbsp; &nbsp; √&nbsp;</td> 
  </tr> 
  <tr> 
   <td>&nbsp; 加载结束事件</td> 
   <td>&nbsp; &nbsp; √</td> 
  </tr> 
 </tbody> 
</table>

<table style="width:600px;"> 
 <tbody> 
  <tr> 
   <th>控件事件&nbsp;&nbsp;</th> 
   <th>参数控件&nbsp;&nbsp;</th> 
   <th>决策报表控件 &nbsp;</th> 
  </tr> 
  <tr> 
   <td>&nbsp; 初始化后</td> 
   <td>&nbsp;&nbsp;√</td> 
   <td>&nbsp; √</td> 
  </tr> 
  <tr> 
   <td>&nbsp; 编辑前</td> 
   <td>&nbsp;&nbsp;</td> 
   <td>&nbsp;&nbsp;</td> 
  </tr> 
  <tr> 
   <td>&nbsp; 编辑后</td> 
   <td>&nbsp;&nbsp;√</td> 
   <td>&nbsp;&nbsp;</td> 
  </tr> 
  <tr> 
   <td>&nbsp; 编辑结束</td> 
   <td>&nbsp;&nbsp;√</td> 
   <td>&nbsp;&nbsp;</td> 
  </tr> 
  <tr> 
   <td>&nbsp; 点击</td> 
   <td>&nbsp;&nbsp;√</td> 
   <td>&nbsp;&nbsp;√</td> 
  </tr> 
  <tr> 
   <td>&nbsp; 值改变</td> 
   <td>&nbsp;&nbsp;</td> 
   <td>&nbsp;&nbsp;</td> 
  </tr> 
  <tr> 
   <td>&nbsp; 节点生成</td> 
   <td>&nbsp;&nbsp;</td> 
   <td>&nbsp;&nbsp;</td> 
  </tr> 
  <tr> 
   <td>&nbsp; 状态改变</td> 
   <td>&nbsp;&nbsp;√</td> 
   <td>&nbsp;&nbsp;√</td> 
  </tr> 
  <tr> 
   <td>&nbsp; 上传后</td> 
   <td>&nbsp;&nbsp;</td> 
   <td>&nbsp;&nbsp;</td> 
  </tr> 
 </tbody> 
</table>

注：决策报表控件是指决策报表 body 里的控件，不包含决策报表参数面板里的控件

## 2. 控件支持的脚本函数 ##

<table> 
 <tbody> 
  <tr> 
   <th>&nbsp;函数名&nbsp;</th> 
   <th>函数描述 &nbsp;</th> 
   <th>补充说明&nbsp;&nbsp;</th> 
   <th>实现 &nbsp;</th> 
   <th>决策报表控件 &nbsp;</th> 
  </tr> 
  <tr> 
   <td>setEnable&nbsp;</td> 
   <td>设置控件的可用性 &nbsp;</td> 
   <td>包含 1 个参数，表示可见</td> 
   <td>√ &nbsp;</td> 
   <td>√ &nbsp;</td> 
  </tr> 
  <tr> 
   <td>isEnable &nbsp;</td> 
   <td>判断控件是否可用 &nbsp;</td> 
   <td>无参数 &nbsp;</td> 
   <td>√ &nbsp;</td> 
   <td>√ &nbsp;</td> 
  </tr> 
  <tr> 
   <td>setVisible &nbsp;</td> 
   <td>设置控件的可见性 &nbsp;</td> 
   <td>包含 1 个参数，表示可见</td> 
   <td>√ &nbsp;</td> 
   <td>√ &nbsp;</td> 
  </tr> 
  <tr> 
   <td>isVisible &nbsp;</td> 
   <td>判断控件的可见性 &nbsp;</td> 
   <td>无参数 &nbsp;</td> 
   <td>√ &nbsp;</td> 
   <td>√ &nbsp;</td> 
  </tr> 
  <tr> 
   <td>setValue &nbsp;</td> 
   <td>设置控件值 &nbsp;</td> 
   <td>无参数&nbsp;</td> 
   <td>√ &nbsp;</td> 
   <td>√ &nbsp;</td> 
  </tr> 
  <tr> 
   <td>getValue &nbsp;</td> 
   <td>获取控件的实际值 &nbsp;</td> 
   <td>无参数&nbsp;</td> 
   <td>√ &nbsp;</td> 
   <td>√ &nbsp;</td> 
  </tr> 
  <tr> 
   <td>reset &nbsp;</td> 
   <td>重置控件 &nbsp;</td> 
   <td>无参数</td> 
   <td>√ &nbsp;</td> 
   <td>√ &nbsp;</td> 
  </tr> 
  <tr> 
   <td>fireEvent &nbsp;</td> 
   <td>触发指定名字的事件&nbsp;</td> 
   <td>包含 1 个参数，表示事件名</td> 
   <td>√ &nbsp;</td> 
   <td>√ &nbsp;<br> &nbsp;</td> 
  </tr> 
 </tbody> 
</table>

## 3. 分页支持的脚本函数 ##

<table> 
 <tbody> 
  <tr> 
   <th>&nbsp;函数名&nbsp;</th> 
   <th>函数描述 &nbsp;</th> 
   <th>补充说明 &nbsp;</th> 
   <th>实现</th> 
  </tr> 
  <tr> 
   <td>contentPane &nbsp;</td> 
   <td>当前报表对象 &nbsp;</td> 
   <td>无 &nbsp;</td> 
   <td>√ &nbsp;</td> 
  </tr> 
  <tr> 
   <td>currentPageIndex &nbsp;</td> 
   <td>当前所在页 &nbsp;</td> 
   <td>contentPane 常用属性 只有分页预览报表才有&nbsp;</td> 
   <td>√ &nbsp;</td> 
  </tr> 
  <tr> 
   <td>reportTotalPage &nbsp;</td> 
   <td>总页数 &nbsp;</td> 
   <td>contentPane 常用属性 只有分页预览报表才有&nbsp;</td> 
   <td>√ &nbsp;</td> 
  </tr> 
  <tr> 
   <td>gotoFirstPage &nbsp;</td> 
   <td>首页 &nbsp;</td> 
   <td>无 &nbsp;</td> 
   <td>√ &nbsp;</td> 
  </tr> 
  <tr> 
   <td>gotoPreviousPage &nbsp;</td> 
   <td>上一页 &nbsp;</td> 
   <td>无 &nbsp;</td> 
   <td>√ &nbsp;</td> 
  </tr> 
  <tr> 
   <td>gotoNextPage &nbsp;</td> 
   <td>下一页 &nbsp;</td> 
   <td>无 &nbsp;</td> 
   <td>√ &nbsp;</td> 
  </tr> 
  <tr> 
   <td>gotoLastPage &nbsp;</td> 
   <td>末页 &nbsp;</td> 
   <td>无 &nbsp;</td> 
   <td>√ &nbsp;</td> 
  </tr> 
  <tr> 
   <td>gotoPage(Number pn [, JSON para] [, Boolean noCache])</td> 
   <td>跳转到某一页 &nbsp;</td> 
   <td>包含三个参数，表示跳转到第几页，对象或字符串，是否使用缓存 &nbsp;</td> 
   <td>√ &nbsp;</td> 
  </tr> 
 </tbody> 
</table>

## 4. 决策平台 ##

<table> 
 <tbody> 
  <tr> 
   <th>函数名 &nbsp;</th> 
   <th>函数描述 &nbsp;</th> 
   <th>&nbsp; 补充说明</th> 
   <th>&nbsp; 实现</th> 
  </tr> 
  <tr> 
   <td>&nbsp;&nbsp;FS.tabPane.addItem</td> 
   <td>&nbsp;&nbsp;向决策平台 Tab 栏新增项目</td> 
   <td>&nbsp; 包含 1 个参数，表示返回值</td> 
   <td>&nbsp;√ &nbsp;</td> 
  </tr> 
  <tr> 
   <td>&nbsp;&nbsp;FS.tabPane.closeActiveTab</td> 
   <td>&nbsp;&nbsp;关闭当前 Tab 选项页</td> 
   <td>&nbsp; 没有参数</td> 
   <td>&nbsp;√&nbsp;</td> 
  </tr> 
  <tr> 
   <td>&nbsp;&nbsp;FR.logoutApp</td> 
   <td>&nbsp;&nbsp;登出，FR 工具类下的方法</td> 
   <td>&nbsp; 没有参数</td> 
   <td>&nbsp;√&nbsp;</td> 
  </tr> 
 </tbody> 
</table>

注：FR.logoutApp 如果是在 App 里面 H5 解析的报表里面用这个 JS，会失效，不会返回到 App 的登录界面；就是 H5 用，比如微信里面，是可以触发登出的。

## 5. 常用的工具脚本函数 ##

<table> 
 <tbody> 
  <tr> 
   <th>函数名 &nbsp;</th> 
   <th>函数描述 &nbsp;</th> 
   <th>补充说明 &nbsp;</th> 
   <th>实现 &nbsp;</th> 
  </tr> 
  <tr> 
   <td>FR.Msg.alert &nbsp;</td> 
   <td>弹出消息框函数 &nbsp;</td> 
   <td>包含 3 个参数，分别表示：标题，内容，回调函数&nbsp;</td> 
   <td>&nbsp;√ &nbsp;</td> 
  </tr> 
  <tr> 
   <td>FR.Msg.confirm &nbsp;</td> 
   <td>值确认弹出框函数 &nbsp;</td> 
   <td>包含 3 个参数，分别表示：标题，值，回调函数&nbsp;</td> 
   <td>&nbsp;√ &nbsp;</td> 
  </tr> 
  <tr> 
   <td>FR.Msg.prompt &nbsp;</td> 
   <td>可修改值的值确认弹出框函数 &nbsp;</td> 
   <td>包含 4 个参数，分别表示：标题，说明，值，回调函数&nbsp;</td> 
   <td>&nbsp;√ &nbsp;</td> 
  </tr> 
  <tr> 
   <td>FR.Msg.toast &nbsp;</td> 
   <td>在页面边缘出现的消息提示块，一小段时间后自动消失&nbsp;</td> 
   <td>包含 1 个参数，表示要提示的信息&nbsp;</td> 
   <td>&nbsp;√ &nbsp;</td> 
  </tr> 
  <tr> 
   <td>FR.doHyperlinkByGet/<br> FR.doHyperlinkByPost &nbsp;</td> 
   <td>超级链接 &nbsp;</td> 
   <td>包含 2 个参数，分别表示：url或json超链定义，传递的参数&nbsp;</td> 
   <td>&nbsp;√ &nbsp;</td> 
  </tr> 
  <tr> 
   <td>FR.cjkEncode</td> 
   <td>对中日韩文做特殊编码转换，返回转换后的字符串</td> 
   <td>包含 1 个参数，表示文本</td> 
   <td>&nbsp;√</td> 
  </tr> 
  <tr> 
   <td>FR.cjkDecode</td> 
   <td>将 cjkEncode 处理过的字符串转化为原始字符串</td> 
   <td>包含 1 个参数，表示文本</td> 
   <td>&nbsp;√</td> 
  </tr> 
  <tr> 
   <td>FR.ajax</td> 
   <td>对 data 参数做中日韩文编码处理</td> 
   <td>包含 1 个参数，表示选项</td> 
   <td>&nbsp;√&nbsp;</td> 
  </tr> 
  <tr> 
   <td>setInterval</td> 
   <td>按照指定的周期（以毫秒计）来调用函数或计算表达式</td> 
   <td>包含 2 个参数，表示代码串，以毫秒计</td> 
   <td>&nbsp;√&nbsp;</td> 
  </tr> 
  <tr> 
   <td>setTimeout</td> 
   <td>在指定的毫秒数后调用函数或计算表达式</td> 
   <td>包含 2 个参数，表示代码串，以毫秒计</td> 
   <td>&nbsp;√&nbsp;</td> 
  </tr> 
  <tr> 
   <td>parameterCommit()</td> 
   <td>触发查询操作</td> 
   <td>无参数</td> 
   <td>&nbsp;√&nbsp;</td> 
  </tr> 
 </tbody> 
</table>