本帖最后由 Richard.Ma 于 2021-12-13 18:52 编辑
Spread.NET 15具有 17 个新的增强型迷你图函数,它们是内置的可视化函数,旨在为仪表板和报告生成数据可视化。视觉功能是一个公式函数,用户可以在单元格中创建一个数据可视化,引用其他单元格 来提供要可视化​​的数据。 我们的 SpreadJS 控件也支持这些迷你图函数,它是Spread的 JavaScript 版本。此功能对于新的增强型相机形状特别有用,可用于创建丰富的交互式仪表板,这些仪表板可根据用户在单元格中的输入有条件地显示各种视觉功能。
以下部分介绍了这些新的增强型迷你图函数:
区域迷你图
AreaSparkline在单元格中创建面积图,这对于比较多个类别、部门、地区等的值趋势非常有用。 AreaSparkline 语法 - =AREASPARKLINE(points, [min, max, line1, line2, colorPositive, colorNegative])
复制代码
- points(必需):要在面积图中绘制的值的范围或数组。如果值不是有效数字,则将其视为0。
- min (可选):表示迷你图最小值的数字。默认值为范围内的最小值。
- max (可选):表示迷你图最大值的数字。默认值为范围内的最大值。
- line1 (可选):表示水平线垂直位置的数字。该行默认不存在。
- line2 (可选):表示另一条水平线的垂直位置的数字。该行默认不存在。
- colorPositive (可选):一个字符串,表示值为正的区域的颜色。默认值为"#787878"。
- colorNegative (可选):一个字符串,表示值为负的区域的颜色。默认值为"#CB0000"。
您可以仅指定 points 参数,也可以指定任何可选参数来覆盖默认值。单元格中呈现的面积图使用不同的颜色显示正值和负值。 示例代码: - =AREASPARKLINE(B8:E8,-30,40,20,0,"#E9958E","#f7a711")
复制代码
箱形图
箱型图(BoxPlotSparkline)可用于显示值的分布以确定数据的可变性或分散性。箱型图比直方图或密度图占用更少的空间,可用于比较多个组或数据集之间的分布。 BoxPlotSparkline 语法 - =BOXPLOTSPARKLINE(points, [boxPlotClass, showAverage, scaleStart, scaleEnd, acceptableStart, acceptableEnd, colorScheme, style, vertical])
复制代码
- points (必需):表示包含值的单元格区域的引用,例如"A1:A4"。
- boxPlotClass(可选):要渲染的箱线图类。以下之一:
boxPlot类 (默认): Q1 –> 25%百分位,Q3 –> 75%百分位,IQR –> Q3-Q1。如果未指定boxPlotClass,则这是默认设置。5ns:须在最小值和最大值处结束,中值,无异常值。7ns:须在2%和98%百分位处结束,阴影线在9%和91%百分位处结束,异常值超出2%和98%百分位。tukey:须以一个值(Q1和Q1之间的点的最小值- 1.5 * IQR,如果存在则使用该点或使用最小值)和一个值(Q3和Q3之间的点的最大值+ 1.5 * IQR,使用该点(如果存在或使用最大值)、超出Q1 - 1.5 * IQR和Q3 + 1.5 * IQR 的异常值,以及超出Q1 - 3 * IQR和Q3 + 3 * IQR 的极端异常值。bowley:须在最小值和最大值处结束,阴影线位于10%和90%百分位,无异常值。sigma3:须以一个值(平均值 - 2 StDev > scaleStart ?average - 2 StDev:最小值)和一个值(平均值 + 2 StDev < scaleEnd ?average = 2 StDev:最大值)结束,框在平均值 +/- stdev,离群值超出平均值 - 2 * StDev和平均值 + 2 * StDev,以及超出平均值 - 3 * StDev和平均值 + 3 * StDev 的极端异常值。 - showAverage(可选):表示是否显示平均值的布尔值。默认值为FALSE。
- scaleStart(可选):表示迷你图最小边界的数字或参考,例如1或"A6"。默认值是所有值中的最小值。
- scaleEnd(可选):表示迷你图最大边界的数字或引用,例如8或"A7"。默认值是所有值中的最大值。
- acceptStart(可选):表示可接受行的开头的数字或引用,例如3或"A8"。默认值为None。
- acceptEnd(可选):数字或引用表示可接受行的结尾,例如5或"A9"。默认值为None。
- colorScheme(可选):表示迷你图框颜色的字符串。默认值为"#D2D2D2"。
- style (可选):表示迷你图样式的数字或参考。默认值为0(经典)。样式可以是0或1。
风格 - 0:晶须是一条线,离群点是一个圆。
- 1:晶须是矩形,离群值是一条线。
vertical (可选):一个布尔值,表示是否垂直显示迷你图。默认值为FALSE。 BoxPlotSparkline非常通用,支持许多可选参数来指定应如何绘制箱线图,包括箱线图类tukey、Bowley、sigma3等,以及不同的须线样式和配色方案。 示例代码: - =BOXPLOTSPARKLINE(B3:M3,"7ns",TRUE,0,100000,5000,10000,"#F58624",0,FALSE)
复制代码
Bullet**图
BulletSparkline可用于显示一组类别的绩效数据(例如关键绩效指标)以进行比较,例如销售人员、地区、产品线等。 BulletSparkline 语法 - =BULLETSPARKLINE(measure, target, maxi, [good, bad, forecast, tickunit, colorScheme, vertical, measureColor, targetColor, maxiColor, goodColor, badColor, forecastColor, allowMeasureOverMaxi, barSize])
复制代码
- measure(必需):表示度量栏长度的数字或参考,例如5或"A1"。
- target(必需):表示目标线位置的数字或引用,例如7或"A2"。
- maxi(必需):表示迷你图最大值的数字或参考,例如10或"A3"。
- good(可选):表示好条长度的数字或参考,例如3或"A4"。默认值为0。
- bad(可选):表示坏条长度的数字或参考,例如1或"A5"。默认值为0。
- forecast (可选):表示预测线长度的数字或参考,例如8或"A6"。默认值为0。
- tickunit(可选):表示刻度单位的数字或引用,例如1或"A7"。默认值为0。
- colorScheme(可选):表示用于生成一组颜色以显示迷你图的配色方案的字符串。默认值为"#A0A0A0"。
- vertical(可选):布尔值,表示是否垂直显示迷你图。默认值为false。
- measureColor(可选):表示度量条颜色的字符串。默认值为"#252525"。
- targetColor(可选):表示目标线颜色的字符串。默认值为"#A0A0A0"。
- maxiColor(可选):表示最大区域颜色的字符串。默认值为"#A0A0A0"。
- goodColor(可选):表示良好区域颜色的字符串。默认值为"#A0A0A0"。
- badColor(可选):表示坏区颜色的字符串。默认值为"#CB0000"。
- predictColor(可选):表示预测线颜色的字符串。默认值为"#3690BF"。
- allowMeasureOverMaxi(可选):布尔值,表示度量是否可以超过最大面积。默认值为false。
- barSize(可选):表示条形宽度/高度与单元格高度/宽度的百分比的数字。该值必须大于0且小于或等于1。默认值为0.6。
BulletSparkline需要指定度量、目标和最大值,所有其他参数都是可选的。BulletSparkline在狭小的空间内呈现大量信息,非常适合用于仪表板和性能度量表。
级联图图 4 CascadeSparkline 示例 CascadeSparkline可用于分析随时间变化的值,例如年销售额、总利润、净税收等。CascadeSparkline广泛用于金融、销售、法律、建筑等。 CascadeSparkline 语法 - =CASCADESPARKLINE(pointsRange, [pointIndex, labelsRange, minimum, maximum, colorPositive, colorNegative, vertical, itemTypeRange, colorTotal])
复制代码
- pointsRange(必需):表示包含值的单元格范围的引用,例如"B2:B8"。
- pointIndex(可选):表示点索引的数字或引用。所述pointIndex是> = 1,如1或“D2” 。默认值由pointsRange 中的点顺序决定。
- labelRange(可选):表示包含标签的单元格范围的引用,例如"A2:A8"。默认值为无标签。
- minimum (可选):表示显示区域最小值的数字或参考。默认值为总和的最小值(点值的总和),例如 -2000。您设置的最小值必须小于默认最小值;否则,将使用默认最小值。
- maximum (可选):表示显示区域最大值的数字或参考。默认值为总和的最大值(点数的总和),如6000。您设置的最大值必须大于默认最大值;否则,将使用默认最大值。
- colorPositive(可选):一个字符串,表示第一个或最后一个正迷你迷你图的框的颜色(该点的值为正)。默认值为"#8CBF64"。如果第一个或最后一个框表示正值,则框的颜色设置为colorPositive。中间的正框设置为比colorPositive更浅的颜色。
- colorNegative(可选):一个字符串,表示第一个或最后一个负迷你迷你图的框的颜色(该点的值为负)。默认值为"#D6604D"。如果第一个或最后一个框表示负值,则框的颜色设置为colorNegative。中间的负框设置为比colorNegative更浅的颜色。
- vertical(可选):一个布尔值,表示框的方向是垂直还是水平。默认值为FALSE。您必须将一组公式的垂直设置为true或false,因为所有公式都代表整个迷你图。
- itemTypeRange(可选):表示数据范围的所有项目类型的数组或引用。值应该是{"-", "+", "=", "#"}或"A1:A7"引用{"+", "-", "=", "#"} 的值,其中“+”表示正变化, “-”表示负变化, “=”表示总列数, “#”表示跳过绘制该项目。
- colorTotal(可选):一个字符串,无论是代表过去的火花线的框的颜色时itemTypeRange不存在或代表总火花的框的颜色时itemTypeRange存在。
CascadeSparkline非常适合会计、预算、库存管理等。CascadeSparkline可以水平或垂直渲染,并使用itemRangeType参数提供精确控制。
衡量KPI
GaugeKPISparkline显示带有各种颜色区域和线指示器的仪表。衡量 KPI可用于显示关键绩效指标结果,以便跨类别、员工等进行比较。 GaugeKPISparkline 语法 =GAUGEKPISPARKLINE( targetValue , currentValue , minValue , maxValue , [ showLabel , targetValueLabel , currentValueLabel , minValueLabel , maxValueLabel , fontArray , minAngle , maxAngle , radiusRatio , GaugeType , colorRange ,…]) - targetValue(必需):目标值的编号或引用。目标值必须介于minValue和maxValue之间。
- currentValue(必需):数字或对当前值的引用。当前值必须介于minValue和maxValue之间。
- minValue(必需):数字或对最小值的引用。该minValue(最小值)必须小于包括maxValue。
- maxValue(必需):数字或对最大值的引用。在包括maxValue必须大于minValue(最小值)。
- showLabel(可选):布尔值或参考,指示是否显示targetValue、 currentValue、 minValue和maxValue的标签。如果showLabel为false,则不会显示任何标签。如果showLabel为true,当单元格宽度或高度不足以显示一个标签时,将显示图形和其他标签,直到单元格有足够的宽度和高度显示图形和所有标签。默认值为true。
- targetValueLabel(可选):字符串或对targetValue显示标签的引用。默认值与targetValue相同。
- currentValueLabel(可选):字符串或对currentValue显示标签的引用。默认值与currentValue相同。
- minValueLabel(可选):字符串或对minValue显示标签的引用。默认值与minValue相同。
- maxValueLabel(可选):字符串或对显示的maxValue标签的引用。默认值与maxValue相同。
- fontArray(可选):数组或引用四个遵循 CSS 字体格式的字体字符串项:第一个用于targetValueLabel(默认值为"16px Calibri"),第二个用于currentValueLabel(默认值为"bold 22px Calibri"),第三个用于minValueLabel(默认值为"12px Calibri"),第四个为maxValueLabel(默认值为"12px Calibri")。仅在showLabel为true 时有效。
- minAngle(可选):数字或引用圆类型的最小角度值。该minAngle必须小于maxAngle。( 0是 12 点钟位置, -90是 9 点钟位置, 90是 3 点钟位置, -180和180是 6 点钟位置)。仅在GaugeType为0(圆形类型)时有效。默认值为-90。
- maxAngle(可选):最大角度值的编号或引用。该maxAngle必须大于minAngle。( 0是 12 点钟位置, -90是 9 点钟位置, 90是 3 点钟位置, -180和180是 6 点钟位置)。默认值为90。仅在GaugeType为0(圆形类型)时有效。默认值为90。
- radiusRatio(可选):数字或参考内圆半径和外圆半径之间的比率。该值必须介于0和1之间。外圆半径值由单元格大小决定。仅在GaugeType为0(圆形类型)时有效。默认值为0。
GaugeType(可选):数字或对 KPI迷你图类型的引用。以下之一: 仪表类型
colorRange(可选):指定特殊颜色范围的数组或参考。第一项是范围的startValue。第二项是endValue值的范围内的。第三项是startValue和endValue之间范围的颜色。将在startValue必须比少endValue值两者之间必须minValue(最小值)和包括maxValue。可以重复此参数以在仪表中指定多个颜色范围(每个都指定startValue、 endValue和color)。默认颜色范围是从minValue到maxValue填充浅灰色。
GaugeKPISparkline非常适合创建仪表板或报告,用于比较销售人员、地区、部门、产品线或任何其他类别的关键绩效指标。一目了然地找到具有低或高性能的重要类别。
HBar 和 VBar
HBarSparkline和VBarSparkline可用于在单元格中创建自定义数据条以表示值。 HBarSparkline 和 VBarSparkline 语法 =HBARSPARKLINE( value , [ colorScheme , axisVisible , barHeight ]) =VBARSPARKLINE( value , [ colorScheme , axisVisible , barWidth ]) - value(必需):表示条形长度的数字或引用,例如0.3或"A1"。如果值大于100%或小于-100%,则会显示一个箭头。
- colorScheme(可选):表示条形颜色的字符串。默认值为"gray"。
- axisVisible(可选):表示是否显示轴的布尔值。默认值为true。
- barHeight(可选):表示条形高度占单元格高度的百分比的数字。该值必须大于0且小于或等于1。
- barWidth(可选):表示条宽占单元格宽度的百分比的数字。该值必须大于0且小于或等于1。
您可以指定自定义颜色、轴和/或自定义条形高度和宽度。将HbarSparkline用于单元格中的水平条,正值从单元格左侧开始,负值从单元格右侧开始,或者使用VbarSparkline作为单元格中的垂直条,正值从单元格底部开始,负值从单元格顶部开始的值。
直方图图 7 HistogramSparkline 示例 HistogramSparkline显示落在各种值范围内的值的计数。甲直方图是用于值的跨一组数据的分布寻找模式是有用的。 直方图Sparkline 语法 = HISTOGRAMSPARKLINE ( dataRange , [ continuous , paintLabel , scale , barWidth , barColor , labelColor , edgeColor ]) - dataRange(必需):数组或值范围,例如"{1,2,2,3,3}"或"A1:C6"。如果单元格值不是有效数字,它将被忽略。
- continuous(可选):如果为true,则直方图是连续的。如果为false,则直方图是离散的。
- PaintLabel(可选):布尔值,表示是否显示数据标签。
- scale(可选):表示直方图连续时数据分箱宽度的数字。必须大于0。
- barWidth(可选):根据平均条宽表示条宽百分比的数字。该值必须大于0且小于或等于1。
- barColor(可选):表示条形颜色的字符串。
- labelFontStyle(可选):表示数据标签 CSS 字体样式的字符串。它支持自定义字体样式、字体粗细、字体系列、字体大小。
- labelColor(可选):表示数据标签字体颜色的字符串。
- edgeColor(可选):表示条形边缘颜色的字符串。
HistogramSparkline可用于通过使用各种比例值查看相同的基础数据来查找不同的模式,并且比例可以使用单元格引用,以便用户可以对其进行调整。
图片
ImageSparkline从 URL 或 base-64 编码字符串并使用指定的大小和显示模式在单元格中显示指定的图像。 ImageSparkline 语法 =IMAGE( source , [ mode , height , width , clipX , clipY , clipHeight , clipWidth , vAlign , hAlign ]) - source(必需):字符串或对网络上图像的 URL 位置的引用,或 base64 编码的图像字符串。
mode (可选):代表图像适合模式的数字。以下之一: mode
- 1:保持比例以适应
- 2:整个图像适合
- 3:适合的原点尺寸
- 4:自定义尺寸以适合
height(可选):模式为4时的数字或图像高度的参考。 - width(可选):模式为4时的数字或引用图像宽度。
- clipX(可选):要绘制到目标上下文中的源图像子矩形左上角的 X 轴坐标。
- clipY(可选):要在单元格中绘制的源图像子矩形左上角的 Y 轴坐标。
- clipHeight(可选):要在单元格中绘制的源图像的子矩形的高度。
- clipWidth(可选):要在单元格中绘制的源图像的子矩形的宽度。
vAlign(可选):该值表示图像的垂直对齐方式。以下之一:
0:顶部
1:中心
2:底部
- hAlign(可选):该值表示图像的水平对齐方式。以下之一:
0:左
1:中心
2:对
ImageSparkline可以通过缩放在单元格中显示整个图像,也可以使用可选参数来显示图像的剪辑部分,以指定要显示图像的哪一部分。
月份和年份
MonthSparkline和YearSparkline将一个月或一年中的天数显示为彩色方块网格。颜色可以由每天的值范围确定,并显示代表空值、最小值、平均值和最大值的颜色,或者通过指定每天的颜色值范围。 MonthSparkline 和 YearSparkline 语法 =MONTHSPARKLINE(年、月、数据范围、emptyColor、startColor、middleColor、endColor) =YEARSPARKLINE( year , dataRange , emptyColor , startColor , middleColor , endColor ) 或者 =MONTHSPARKLINE(年,月,数据范围,颜色范围) =YEARSPARKLINE(年份,数据范围,颜色范围) - year(必填):完整的年份编号,例如2015。
- month(必填):月份编号,例如3。
- dataRange(必需):引用表示一个范围,其中第一列是日期,第二列是数字,例如"A1:B400"。
- emptyColor(必需):颜色字符串表示没有值或零值的日期,例如"lightgray"。
- startColor(必需):颜色字符串表示该值为最小值的日期,例如"lightgreen"。
- middleColor(必需):颜色字符串表示值在最小值和最大值的平均值附近的日期,例如"green"。
- endColor(必需):颜色字符串表示值为最大值的日期,例如"darkgreen"。
- colorRange(必需):包含每天颜色字符串的数组或参考。
MonthSparkline和YearSparkline非常适合显示跨时间的一组值,以快速找到跨季节、季度、商业周期等的模式。
帕累托图
ParetoSparkline可用于使用帕累托分布曲线显示和比较排序的值集。ParetoSparkline渲染与前一个相邻的单元格中的条形以创建帕累托分布曲线。 帕累托迷你图语法 =PARETOSPARKLINE( points , [ pointIndex , colorRange , target , target2 , highlightPosition , label , vertical , targetColor , target2Color , labelColor , barSize ]) ParetoSparkline可用于查找流程改进的重点领域,以最大限度地发挥影响并优化资源。
饼图
PieSparkline在单元格中创建一个饼图,这对于显示跨类别、部门、区域等的相对百分比很有用。 PieSparkline 语法 = PIESPARKLINE(百分比,[颜色1,颜色2,...]) - 百分比(必需):饼图切片的值。如果参数是一个单元格(例如"A1"),则百分比是单元格的值。如果参数是一个范围(例如"A1:B3"),则百分比是每个单元格的值除以范围总和的结果。如果参数是百分比值(例如"30%"或0.3),则百分比是值。如果解析的值无效,则将其视为0。
- 颜色1,颜色2,...(可选):表示每一个扇区的颜色字符串值。如果颜色参数计数大于等于范围计数,则数值与颜色一一对应;多余的颜色将被忽略。如果颜色参数计数小于范围计数,则重复使用给定的颜色并使用线性渐变来确保每个扇区具有不同的颜色。如果没有颜色,则使用“darkgray”作为默认值。
PieSparkline可用于显示各种类别对总数的相对百分比贡献。
散点图
ScatterSparkline可用于在一组数据中绘制和比较两组关联值。 ScatterSparkline 语法 = SCATTERSPARKLINE(points1,[ points2,其minX,maxX的,MINY,MAXY,HLINE,VLINE,xMinZone,xMaxZone,yMinZone,yMaxZone,标签,drawSymbol,drawLines,颜色1,颜色2,破折号]) - points1(必需):第一个 x,y 数据系列的范围或数组,例如"H1:I6"。如果行数大于等于列数,则从前两列获取数据;第一列包含 x 值,第二列包含 y 值。否则,从前两行获取数据;第一行包含 x 值,第二行包含 y 值。
- points2(可选): x,y 数据的第二个系列。它是一个范围,例如"J1:K6"。如果行数大于等于列数,则从前两列获取数据;第一列包含 x 值,第二列包含 y 值。否则,从前两行获取数据;第一行包含 x 值,第二行包含 y 值。
- minX(可选):两个系列的x下限;如果省略,每个系列都有自己的值。
- maxX(可选):两个系列的x最大限制;如果省略,每个系列都有自己的值。
- minY(可选):两个系列的 y 最小值;如果省略,每个系列都有自己的值。
- maxY(可选):两个系列的y最大值;如果省略,每个系列都有自己的值。
- hLine(可选):水平轴的位置;如果省略,则没有行。
- vLine(可选):垂直轴的位置;如果省略,则没有行。
- xMinZone(可选):灰色区域的x最小值;如果省略这四个区域参数中的任何一个,则没有灰色区域。
- xMaxZone(可选):灰色区域的x最大值;如果省略这四个区域参数中的任何一个,则没有灰色区域。
- yMinZone(可选):灰色区域的y最小值;如果省略这四个区域参数中的任何一个,则没有灰色区域。
- yMaxZone(可选):灰色区域的y最大值;如果省略这四个区域参数中的任何一个,则没有灰色区域。
- 标签(可选):如果为true,则将第一个系列中 y 值最大的点标记为"#0000FF",将第一个系列中y 值最小的点标记为"#CB0000"。默认值为false。
- drawSymbol(可选):如果为true,则将每个点绘制为一个符号。第一个系列的符号是一个圆圈,第二个系列的符号是一个正方形。默认值为true。
- drawLines(可选):如果为true,则在每个系列中按顺序将每个点与一条线连接起来。默认值为false。
- color1(可选):第一个系列点的颜色字符串;默认值为"#969696"。
- color2(可选):第二系列点的颜色字符串;默认值为"#CB0000"。
- dash(可选):如果为true,则该线为虚线;否则,该行是整行。默认值为false。
传播图 13 SpreadSparkline 示例 SpreadSparkline显示线条或点以指示一组值的出现频率。 Sparkline 语法 =SPREADSPARKLINE( points , [ showAverage , scaleStart , scaleEnd , style , colorScheme , vertical ]) SpreadSparkline可用于查找趋势和异常值。
堆积图图 14 StackedSparkline 示例 StackedSparkline在单元格中显示一个堆积条形图,显示累积值,如堆积柱形图或条形图。 StackedSparkline 语法 = STACKEDSPARKLINE(分,[ colorRange,labelRange,最大,targetRed,targetGreen,targetBlue,targetYellow,颜色,highlightPosition,垂直,textOrientation,TEXTSIZE ]) StackedSparkline可用于比较一个公共变量或一组类别中的两个或多个系列值。
方差图
图 15 VariSparkline 示例 VariSparkline可用于比较两组数据并显示它们之间的差异或方差。 VariSparkline 语法 =VARISPARKLINE( variance , [ reference , mini , maxi , mark , tickunit , legend , colorPositive , colorNegative , vertical ]) - 方差(必需):表示条形长度的数字或参考,例如2或"A1"。
- 参考(可选):表示参考线位置的数字或参考,例如0或"A2"。默认值为0。
- mini(可选):表示迷你图最小值的数字或参考,例如-5或"A3"。默认值为-1。
- maxi(可选):表示迷你图最大值的数字或参考,例如5或"A4"。默认值为1。
- 标记(可选):表示标记在行上的位置的数字或引用,例如3或"A5"。默认值为0。
- tickunit(可选):表示刻度单位的数字或引用,例如1或"A6"。默认值为0。
- 图例(可选):布尔值,表示是否显示文本。默认值为false。
- colorPositive(可选):表示方差大于参考时的配色方案的字符串。默认值为"green"。
- colorNegative(可选):表示方差小于参考时的配色方案的字符串。默认值为"red"。
- 垂直(可选):布尔值,表示框的方向是垂直还是水平。默认值为false。
VariSparkline将方差显示为正百分比,绿色条延伸到中心轴的右侧,或显示为负百分比,红色条延伸到中心轴的左侧。
|