历史版本20 :单元格对象接口 返回文档
编辑时间: 内容长度:图片数:目录数: 修改原因:

目录:

版本编辑

报表服务器版本移动端版本功能变动
11.0
-

和 10.0 区别:

10.0 无此类接口

11.0.7-决策报表新增 getPosition、getRow、getColumn、getValue、showToolTip、setStyle 接口。
11.0.7-安装了「FineVis数据可视化」插件 V1.8.0 及之后版本,FVS 可视化看板支持 getPosition、getRow、getColumn、getValue、showToolTip、setStyle 接口。
11.0.1011.0.70普通报表支持 getPosition、getRow、getColumn、getValue、showToolTip、setStyle 接口。

在使用接口前,请务必先仔细阅读 JS API 兼容说明,接口默认支持普通报表和决策报表(新版)。

getPosition编辑

方法getPosition()

获取当前单元格位置信息,使用时需要先获取到单元格对象

     参数

-

-

   返回值Position:Array单元格的位置,数组类型,下标从 0 开始,0 表示行,1 表示列
     示例

示例1:若获取到的单元格对象定义为 cell ,返回当前单元格的位置、行位置、列位置

cell.getPosition();//cell单元格对象的位置信息
cell.getPosition()[0];//cell单元格对象的行位置
cell.getPosition()[1];//cell单元格对象的列位置

示例2:返回决策报表中 report0 报表块中 A1 单元格的位置信息

_g().getWidgetByName('report0').getCell(1,1).getPosition();

示例3:返回普通报表中 A1 单元格的位置信息

_g().getCell(1,1).getPosition();

示例4:返回 FVS 可视化看板中「表格1」组件 A1 单元格的位置信息

duchamp.getWidgetByName("表格1").getCell(1,1).getPosition();

示例5:弹窗提示决策报表中 report0 报表块中 A1 单元格的行列信息

var row=_g().getWidgetByName('report0').getCell(1,1).getPosition()[0];
var col=_g().getWidgetByName('report0').getCell(1,1).getPosition()[1];
FR.Msg.alert("提示","A1单元格的行位置是"+row+"列位置是"+col);
  应用示例

点击按钮,弹窗提示决策报表中 report0 报表块中 A1 单元格的行列信息

点击下载模板:获取单元格对象的位置.frm

FVS 可视化看板:获取单元格对象的位置.fvs

2022-08-26_14-38-50.gif

   移动端支持移动端

getRow编辑

方法getRow()

获取当前单元格所在的行单元格对象,返回的行对象可调用 行对象上的方法

     参数

-

-

   返回值

Object

行单元格对象,json 格式。当单元格合并时,返回单元格行对象组,假设将A1、A2单元格合并,则返回 第 1 行对象, 第 2 行对象。

     示例

示例1:若获取到的单元格对象定义为 cell ,返回当前单元格所在的行单元格对象

cell.getRow();

示例2:获取决策报表中 report0 报表块中 A1 单元格所在的行单元格对象

_g().getWidgetByName('report0').getCell(1,1).getRow();

示例3:获取普通报表中 A1 单元格所在的行单元格对象:

_g().getCell(1, 1).getRow();

示例4:获取 FVS 可视化看板中「表格1」组件 A1 单元格所在的行单元格对象

duchamp.getWidgetByName("表格1").getCell(1,1).getRow();

示例5:修改决策报表中 report0 报表块中 A1 单元格所在的行单元格内容字体为红色、14号

_g().getWidgetByName('report0').getCell(1, 1).getRow().setStyle({
fontSize: 14,
color: 'red'
});
  应用示例

修改决策报表中 report0 报表块中 A1 单元格所在的行单元格内容字体为红色、14号

点击下载模板:修改单元格所在行的样式.frm

FVS 可视化看板:修改单元格所在行的样式.fvs

2022-08-26_15-23-32.gif

   移动端支持移动端

getColumn编辑

方法getColumn()

获取当前单元格所在的列单元格对象,返回的列对象可调用 列对象上的方法

     参数

-

-

   返回值

Object

列单元格对象,JSON 格式。当单元格合并时,返回单元格列对象组,假设将A1、B1单元格合并,则返回第 1 列对象, 第 2 列对象。

     示例

示例1:若获取到的单元格对象定义为 cell ,返回当前单元格所在的列单元格对象

cell.getColumn();

示例2:获取决策报表中 report0 报表块中 A1 单元格所在的列单元格对象

_g().getWidgetByName('report0').getCell(1,1).getColumn();

示例3:获取普通报表中 A1 单元格所在的列单元格对象:

_g().getCell(1,1).getColumn();

示例4:获取 FVS 可视化看板中「表格1」组件 A1 单元格所在的列单元格对象

duchamp.getWidgetByName("表格1").getCell(1,1).getColumn();

示例5:修改决策报表中 report0 报表块中 A1 单元格所在的列单元格内容字体为红色、14号

_g().getWidgetByName('report0').getCell(1,1).getColumn().setStyle({
fontSize: 14,
color: 'red'
});
  应用示例

修改决策报表中 report0 报表块中 A1 单元格所在的列单元格内容字体为红色、14号

点击下载模板:修改单元格所在列的样式.frm

FVS 可视化看板:修改单元格所在列的样式.fvs

2022-08-26_15-40-39.gif

   移动端支持移动端

getValue编辑

方法getValue()

获取单元格的类型和值

     参数

-

-

   返回值

string

单元格的类型和值

     示例

示例1:若获取到的单元格对象定义为 cell ,返回当前单元格的类型和值

cell.getValue();

示例2:获取决策报表中 report0 报表块中 A1 单元格的类型和值

_g().getWidgetByName('report0').getCell(1,1).getValue();

示例3:获取普通报表 A1 单元格的类型和值

_g().getCell(1,1).getValue();

示例4:获取 FVS 可视化看板中「表格1」组件 A1 单元格的类型和值

duchamp.getWidgetByName("表格1").getCell(1,1).getValue();

示例5:弹窗打印决策报表中 report0 报表块中 A1 单元格的类型和值

var a=_g().getWidgetByName('report0').getCell(1,1).getValue();
FR.Msg.alert("提示","A1单元格的值是"+a);
  应用示例

弹窗打印决策报表中 report0 报表块中 A1 单元格的类型和值

点击下载模板:点击显示单元格的值.frm

FVS 可视化看板:获取单元格值.fvs

   移动端支持移动端

setValue编辑

注:仅支持 FVS 可视化看板

方法setValue(value)

设置单元格的值

     参数

value:any

单元格值,任意格式

   返回值

void

     示例

示例:FVS 可视化看板中给「表格1」组件 A1 单元格赋值为「其他地区」

duchamp.getWidgetByName("表格1").getCell(1,1).setValue("其他地区");


  应用示例

点击下载模板:点击修改单元格值.fvs

AD332B3A-DABE-4B4B-9017-BAE12F4DBDF0.GIF

   移动端不支持移动端

showToolTip编辑

方法

showToolTip(opts)

给报表单元格添加提示

     参数

opts: Object

{

    show: boolean,

    content: { 

        text: string, // 文字

        image: string, // 图片

        header: string // 标题

    }

    style: { 

    }

}

注:普通报表不支持 header 和 image 参数


opts: 弹窗选项,是个对象

1)show:是否会出现弹窗,布尔型,true 为出现,false 为不出现

2)content:可选字段,不指定即为显示文字,内容为单元格中的值

  • text: 提示的内容,字符串

  • image: 图片 URL 路径,字符串,图片格式支持 pn   g、jpg。图片来源可以为网页图片,如:

https://www.fanruan.com/images/logo-fanruan.png

也可以将图片放置在报表工程目录 %FR_HOME%\webapps\webroot 下,通过URL 访问。如:

http://localhost:8075/webroot/11.jpg
  • header: 标题

3)style: 可选字段,不指定则为默认样式,支持的样式可参考:单元格样式属性style

   返回值

-

-

     示例

示例1:将获取到的单元格对象定义为 cell,给单元格设置一个标题为“提示”,内容为红色“地区销售数据”字样的提示框: 

cell.showToolTip({
show: true// 是否会出现弹窗
content: { // 可选字段,不指定即为显示文字
text: "地区销售数据"// 文字
header: "提示" // 标题
},
style: { // 可选字段,不指定为默认样式,支持css标准样式的字段
color: "#DC143C"
//符合css规则
}
});

示例2:给决策报表中 report0 报表块 A1 单元格设置一个标题为“提示”,内容为红色“地区销售数据”字样的提示框: 

_g().getWidgetByName('report0').getCell(1,1).showToolTip({
show: true// 是否会出现弹窗
content: { // 可选字段,不指定即为显示文字,内容为cell.getValue();
text: "地区销售数据"// 文字
header: "提示" // 标题
},
style: { // 可选字段,不指定为默认样式,支持css标准样式的字段
color: "#DC143C"
//符合css规则
}
});

示例3:给普通报表 A1 单元格设置一个标题为“提示”,内容为红色“地区销售数据”字样的提示框: 

_g().getCell(1,1).showToolTip({
show: true, // 是否会出现弹窗
content: { // 可选字段,不指定即为显示文字,内容为cell.getValue();
text: "地区销售数据", // 文字
header: "提示" // 标题
},
style: { // 可选字段,不指定为默认样式,支持css标准样式的字段
color: "#DC143C"
//符合css规则
}
});

示例4:给 FVS 可视化看板中「表格1」组件 A1 单元格设置一个标题为“提示”,内容为单元格值的提示框

duchamp.getWidgetByName("表格1").getCell(1,1).showToolTip({
show: true, // 是否会出现弹窗
content: { // 可选字段,不指定即为显示文字
header: "提示" // 标题
}
});

示例5:给决策报表中 report0 报表块 A1 单元格设置一个标题为“提示”,内容为单元格值的提示框: 

_g().getWidgetByName('report0').getCell(1,1).showToolTip({
show: true, // 是否会出现弹窗
content: { // 可选字段,不指定即为显示文字
header: "提示" // 标题
}
});
  应用示例

给决策报表中 report0 报表块 A1 单元格设置一个标题为“提示”,内容为单元格值的提示框: 

点击可下载模板:鼠标悬浮单元格文字提示.frm

FVS 可视化看板:鼠标悬浮单元格文字提示.fvs

   移动端不支持移动端

setStyle编辑

方法

setStyle(opts)

设置单元格对象的样式

     参数

opts: Object

{

    fontFamily: String

    fontSize: number

    fontWeight: String

    color: String

  ........

}

opts: 单元格格式属性,如边框、背景、字体颜色等,支持的属性可查看:单元格样式属性style

   返回值

-

-
     示例

示例1:若获取到的单元格对象为 cell ,设置该单元格的样式为字体颜色红色、字号14 号

cell.setStyle({
fontSize: 14,
color: 'red'
});

示例2:给普通报表 A1 单元格的样式设置为字体颜色红色、字号14 号

_g().getCell(1,1).setStyle({
fontSize: 14,
color: 'red'
});

示例4:将 FVS 可视化看板中「表格1」组件 A1 单元格的样式设置为字体颜色红色、字号 20 号

duchamp.getWidgetByName("表格1").getCell(1,1).setStyle({
fontSize: 20,
color: 'red'
});

示例5:将决策报表中将 report0 报表块 A1 单元格的样式设置为字体颜色红色、字号14 号

_g().getWidgetByName('report0').getCell(1,1).setStyle({
fontSize: 14,
color: 'red'
});
  应用示例

点击按钮,将决策报表中 report0 报表块 A1 单元格的字体设置为红色、加粗、14 号:

点击可下载模板:获取单元格后修改单元格样式.frm

FVS 可视化看板:获取单元格后修改单元格样式.fvs

2022-08-16_19-47-08.gif

   移动端支持移动端