[{"id":"b66f8b1e-cc14-4e89-9679-abd5687d283d","tags":[{"product":null,"links":null,"id":"9e117e35-984a-4c14-95ca-ef0ec7b9fb60","name":"\u65B0\u589E","color":"DarkGreen","productId":"098be112-50ec-44e4-b746-6bc8bf76af97"}]},{"id":"569bb90a-ea68-46c6-96f1-ab151c120714","tags":[{"product":null,"links":null,"id":"a2f84374-4a3f-4d22-96fd-765e9de495bf","name":"\u66F4\u65B0","color":"Coral","productId":"098be112-50ec-44e4-b746-6bc8bf76af97"}]},{"id":"5eb52f08-2d1a-4362-9ffc-4871bdc10f3f","tags":[{"product":null,"links":null,"id":"a2f84374-4a3f-4d22-96fd-765e9de495bf","name":"\u66F4\u65B0","color":"Coral","productId":"098be112-50ec-44e4-b746-6bc8bf76af97"}]},{"id":"341dd607-b97d-4d70-bde2-53acda6b6c95","tags":[{"product":null,"links":null,"id":"a2f84374-4a3f-4d22-96fd-765e9de495bf","name":"\u66F4\u65B0","color":"Coral","productId":"098be112-50ec-44e4-b746-6bc8bf76af97"}]},{"id":"05349273-414f-4208-9ea2-c4fc8f4ea2cb","tags":[{"product":null,"links":null,"id":"a2f84374-4a3f-4d22-96fd-765e9de495bf","name":"\u66F4\u65B0","color":"Coral","productId":"098be112-50ec-44e4-b746-6bc8bf76af97"}]},{"id":"86089f76-b778-4d52-821e-6f27de3df613","tags":[{"product":null,"links":null,"id":"9e117e35-984a-4c14-95ca-ef0ec7b9fb60","name":"\u65B0\u589E","color":"DarkGreen","productId":"098be112-50ec-44e4-b746-6bc8bf76af97"}]},{"id":"b81e4fd6-1fc5-43a0-a258-b6e16a5cbec6","tags":[{"product":null,"links":null,"id":"a2f84374-4a3f-4d22-96fd-765e9de495bf","name":"\u66F4\u65B0","color":"Coral","productId":"098be112-50ec-44e4-b746-6bc8bf76af97"}]},{"id":"8aa8ce31-43e4-438e-951f-241608435260","tags":[{"product":null,"links":null,"id":"a2f84374-4a3f-4d22-96fd-765e9de495bf","name":"\u66F4\u65B0","color":"Coral","productId":"098be112-50ec-44e4-b746-6bc8bf76af97"}]},{"id":"37343f41-6ec2-4c7e-b21d-2cc18d5ce1e0","tags":[{"product":null,"links":null,"id":"a2f84374-4a3f-4d22-96fd-765e9de495bf","name":"\u66F4\u65B0","color":"Coral","productId":"098be112-50ec-44e4-b746-6bc8bf76af97"}]},{"id":"5915e52f-64f8-4146-b8bd-81bead6324a3","tags":[{"product":null,"links":null,"id":"a2f84374-4a3f-4d22-96fd-765e9de495bf","name":"\u66F4\u65B0","color":"Coral","productId":"098be112-50ec-44e4-b746-6bc8bf76af97"}]},{"id":"836ba889-af9e-460d-a4cc-c24d922795f2","tags":[{"product":null,"links":null,"id":"a2f84374-4a3f-4d22-96fd-765e9de495bf","name":"\u66F4\u65B0","color":"Coral","productId":"098be112-50ec-44e4-b746-6bc8bf76af97"}]},{"id":"4ae14b06-bb68-4394-a210-a46b8f028346","tags":[{"product":null,"links":null,"id":"a2f84374-4a3f-4d22-96fd-765e9de495bf","name":"\u66F4\u65B0","color":"Coral","productId":"098be112-50ec-44e4-b746-6bc8bf76af97"}]},{"id":"d8f42066-e9dc-4411-bdcf-43b1a203370c","tags":[{"product":null,"links":null,"id":"9e117e35-984a-4c14-95ca-ef0ec7b9fb60","name":"\u65B0\u589E","color":"DarkGreen","productId":"098be112-50ec-44e4-b746-6bc8bf76af97"}]},{"id":"7ef86f16-b1a0-49f7-9592-612b9be02b25","tags":[{"product":null,"links":null,"id":"a2f84374-4a3f-4d22-96fd-765e9de495bf","name":"\u66F4\u65B0","color":"Coral","productId":"098be112-50ec-44e4-b746-6bc8bf76af97"}]},{"id":"b29c7775-a9a4-451e-a1b5-01d19ed5ca5e","tags":[{"product":null,"links":null,"id":"9e117e35-984a-4c14-95ca-ef0ec7b9fb60","name":"\u65B0\u589E","color":"DarkGreen","productId":"098be112-50ec-44e4-b746-6bc8bf76af97"}]},{"id":"e56f3989-8f81-46af-90fa-a4813eeb976f","tags":[{"product":null,"links":null,"id":"9e117e35-984a-4c14-95ca-ef0ec7b9fb60","name":"\u65B0\u589E","color":"DarkGreen","productId":"098be112-50ec-44e4-b746-6bc8bf76af97"}]},{"id":"2526c963-f170-45a8-923e-91b0712a9810","tags":[{"product":null,"links":null,"id":"9e117e35-984a-4c14-95ca-ef0ec7b9fb60","name":"\u65B0\u589E","color":"DarkGreen","productId":"098be112-50ec-44e4-b746-6bc8bf76af97"}]},{"id":"24575cf0-501a-44f9-8426-c40f8f4b5552","tags":[{"product":null,"links":null,"id":"a2f84374-4a3f-4d22-96fd-765e9de495bf","name":"\u66F4\u65B0","color":"Coral","productId":"098be112-50ec-44e4-b746-6bc8bf76af97"}]},{"id":"1a6f8d7f-acd6-42be-8c4f-f464c6218381","tags":[{"product":null,"links":null,"id":"a2f84374-4a3f-4d22-96fd-765e9de495bf","name":"\u66F4\u65B0","color":"Coral","productId":"098be112-50ec-44e4-b746-6bc8bf76af97"}]},{"id":"82b176fd-5cab-498c-909e-8fa7d29c38d8","tags":[{"product":null,"links":null,"id":"9e117e35-984a-4c14-95ca-ef0ec7b9fb60","name":"\u65B0\u589E","color":"DarkGreen","productId":"098be112-50ec-44e4-b746-6bc8bf76af97"}]},{"id":"1708b3a9-4f37-44a8-8f0e-f9a2d2e5d940","tags":[{"product":null,"links":null,"id":"9e117e35-984a-4c14-95ca-ef0ec7b9fb60","name":"\u65B0\u589E","color":"DarkGreen","productId":"098be112-50ec-44e4-b746-6bc8bf76af97"}]},{"id":"c9ac246e-29fb-4bc4-8231-8439795bb590","tags":[{"product":null,"links":null,"id":"9e117e35-984a-4c14-95ca-ef0ec7b9fb60","name":"\u65B0\u589E","color":"DarkGreen","productId":"098be112-50ec-44e4-b746-6bc8bf76af97"}]},{"id":"94f2a5c3-2539-436a-af75-23fbbd1a3957","tags":[{"product":null,"links":null,"id":"a2f84374-4a3f-4d22-96fd-765e9de495bf","name":"\u66F4\u65B0","color":"Coral","productId":"098be112-50ec-44e4-b746-6bc8bf76af97"}]},{"id":"d99594f4-2d40-4df4-9419-ba2ca6aa3f7f","tags":[{"product":null,"links":null,"id":"9e117e35-984a-4c14-95ca-ef0ec7b9fb60","name":"\u65B0\u589E","color":"DarkGreen","productId":"098be112-50ec-44e4-b746-6bc8bf76af97"}]},{"id":"fd66e72d-0f10-4f57-9807-6db26290ab2e","tags":[{"product":null,"links":null,"id":"a2f84374-4a3f-4d22-96fd-765e9de495bf","name":"\u66F4\u65B0","color":"Coral","productId":"098be112-50ec-44e4-b746-6bc8bf76af97"}]},{"id":"8f344863-503d-4bc3-a594-3815e7d55f5c","tags":[{"product":null,"links":null,"id":"9e117e35-984a-4c14-95ca-ef0ec7b9fb60","name":"\u65B0\u589E","color":"DarkGreen","productId":"098be112-50ec-44e4-b746-6bc8bf76af97"}]},{"id":"9be82601-de9d-4c18-948a-23ab6f4dd431","tags":[{"product":null,"links":null,"id":"9e117e35-984a-4c14-95ca-ef0ec7b9fb60","name":"\u65B0\u589E","color":"DarkGreen","productId":"098be112-50ec-44e4-b746-6bc8bf76af97"}]},{"id":"6495f3c0-b463-47e0-b08a-ca949672211e","tags":[{"product":null,"links":null,"id":"9e117e35-984a-4c14-95ca-ef0ec7b9fb60","name":"\u65B0\u589E","color":"DarkGreen","productId":"098be112-50ec-44e4-b746-6bc8bf76af97"}]},{"id":"b4bede08-3f08-4839-ba4a-abc7ac195bde","tags":[{"product":null,"links":null,"id":"9e117e35-984a-4c14-95ca-ef0ec7b9fb60","name":"\u65B0\u589E","color":"DarkGreen","productId":"098be112-50ec-44e4-b746-6bc8bf76af97"}]},{"id":"4afcdfc0-3ff5-4f2b-a223-f8fc042a5bbe","tags":[{"product":null,"links":null,"id":"9e117e35-984a-4c14-95ca-ef0ec7b9fb60","name":"\u65B0\u589E","color":"DarkGreen","productId":"098be112-50ec-44e4-b746-6bc8bf76af97"}]},{"id":"422062c4-fa40-4771-a86f-008efe6d86e5","tags":[{"product":null,"links":null,"id":"9e117e35-984a-4c14-95ca-ef0ec7b9fb60","name":"\u65B0\u589E","color":"DarkGreen","productId":"098be112-50ec-44e4-b746-6bc8bf76af97"}]},{"id":"d87e8013-86a7-4840-8d25-6f62e14eb4ac","tags":[{"product":null,"links":null,"id":"9e117e35-984a-4c14-95ca-ef0ec7b9fb60","name":"\u65B0\u589E","color":"DarkGreen","productId":"098be112-50ec-44e4-b746-6bc8bf76af97"}]},{"id":"a6acedfd-4043-4c64-a5d1-aec3326df9e7","tags":[{"product":null,"links":null,"id":"9e117e35-984a-4c14-95ca-ef0ec7b9fb60","name":"\u65B0\u589E","color":"DarkGreen","productId":"098be112-50ec-44e4-b746-6bc8bf76af97"}]},{"id":"dbdc0b24-06c4-48b9-8d6c-7455119dc773","tags":[{"product":null,"links":null,"id":"9e117e35-984a-4c14-95ca-ef0ec7b9fb60","name":"\u65B0\u589E","color":"DarkGreen","productId":"098be112-50ec-44e4-b746-6bc8bf76af97"}]},{"id":"a3856849-954a-4cfc-96a6-382e530d3638","tags":[{"product":null,"links":null,"id":"a2f84374-4a3f-4d22-96fd-765e9de495bf","name":"\u66F4\u65B0","color":"Coral","productId":"098be112-50ec-44e4-b746-6bc8bf76af97"}]},{"id":"4a39306b-ffa5-433d-80a3-28e41f929b72","tags":[{"product":null,"links":null,"id":"a2f84374-4a3f-4d22-96fd-765e9de495bf","name":"\u66F4\u65B0","color":"Coral","productId":"098be112-50ec-44e4-b746-6bc8bf76af97"}]}]
        
(Showing Draft Content)

格式字符串

在SpreadJS中,用户可以在一个单元格中同时设置值和公式。 您还可以根据单元格中的公式设置显示文本的格式。 样式格式化程序中的格式字符串用公式或文本值模板扩展,这些模板或文本值模板自定义单元格中的显示值。 单元格值用作格式化程序的参数,该格式化程序将其作为图像或更新的文本呈现在单元格中。

格式化程序分为以下三种情况:

格式化的类型 语法格式 示例
Normal cell formatter Standard formatter "#,##0_);(#,##0)"

"h:mm AM/PM"

Format string - Formula Standard formula "=SUM(@, C1)"

"=AVERAGE(C4:C7)"

Format string - Text value Template Text string where formula is contained in "{{" "}}" "After {{=@}} approval, Total Sales Were: {{=SUM(Sales4)}}"

“Hello, @”

'@' 符号表示当前单元格引用,可以直接在公式或文本值模板中使用。

格式化字符串 - 公式

除了设置单元格值之外,还可以将公式设置为Style的格式设置器。 可以在公式中使用“ @”符号来引用当前单元格。

例如,可以将一个单元格值设置为范围A1:A2的总和:

格式字符串 - 文字值模板

文本值模板对于创建仪表板和汇总数据非常有用。 使用文本值模板,可以将文本值和公式组合在单个单元格中,并且可以在“ {{”和“}}”内部使用以将公式包装在字符串中。

例如,单元格值可以与日期值,求和公式和静态文本结合使用:

格式字符串非常有用,通常可用于以下情况:

  • 格式化长显示字符串而不是使用串联公式
  • 以其他货币或单位显示值,而无需变更基础值
  • 使用条形码和迷你图功能显示值或范围的图形表示
  • 使用“Number to Words”函数将数值显示为字
  • 在仪表板或报告中显示值的KPI范围模板

使用场景

场景1

可以将数字变更为单词,并且只要变更单元格的值,它们的值就会自动更新。

代码

此示例代码实现了一个自定义功能,用于基于单元格值以单词显示数字。

// 初始化 Spread
var spread = new GC.Spread.Sheets.Workbook(document.getElementById('ss'), { sheetCount: 1 });
// 数字转文字
var sheet1 = spread.getSheet(0);
sheet1.name('Number to Words');
spread.addCustomName('n_1', '{"";" One";" Two";" Three";" Four";" Five";" Six";" Seven";" Eight";" Nine";" Ten";" Eleven";" Twelve";" Thirteen";" Fourteen";" Fifteen";" Sixteen";" Seventeen";" Eighteen";" Nineteen"}');
spread.addCustomName('n_2', '{"";0;" Twenty";" Thirty";" Forty";" Fifty";" Sixty";" Seventy";" Eighty";" Ninety"}');
spread.addCustomName('n_3', '{"";"-One";"-Two";"-Three";"-Four";"-Five";"-Six";"-Seven";"-Eight";"-Nine"}');
var numberToWordsStyle = new GC.Spread.Sheets.Style();
numberToWordsStyle.formatter = '=TRIM(REPT(INDEX(n_1,1+INT(@/10^8))&" hundred",10^8<@)&IF(@-TRUNC(@,-8)<2*10^7,INDEX(n_1,1+MID(TEXT(@,"000000000"),2,2)),INDEX(n_2,1+MID(TEXT(@,"000000000"),2,2)/10)&INDEX(n_3,1+RIGHT(INT(@/10^6))))&REPT(" million",10^6<@)&IF(--RIGHT(INT(@/10^5)),INDEX(n_1,1+RIGHT(INT(@/10^5)))&" hundred","")&IF(@-TRUNC(@,-5)<2*10^4,INDEX(n_1,1+MID(TEXT(@,"000000000"),5,2)),INDEX(n_2,1+MID(TEXT(@,"000000000"),5,2)/10)&INDEX(n_3,1+RIGHT(INT(@/10^3))))&IF(--MID(TEXT(@,"000000000"),4,3)," thousand","")&IF(--RIGHT(INT(@/100)),INDEX(n_1,1+RIGHT(INT(@/100)))&" hundred","")&IF(MOD(@,100)<20,INDEX(n_1,1+RIGHT(@,2)),INDEX(n_2,1+RIGHT(@,2)/10)&INDEX(n_3,1+RIGHT(@))))';
numberToWordsStyle.name = 'NumberToWords';
numberToWordsStyle.backColor = "lightblue";
spread.addNamedStyle(numberToWordsStyle);
sheet1.setColumnWidth(1, 700);
sheet1.setStyleName(1, 1, 'NumberToWords');
sheet1.getCell(1, 1).value(765348921).hAlign(GC.Spread.Sheets.HorizontalAlign.center);
sheet1.setColumnWidth(1, 700);

场景2

考虑另一种情况,可以通过从下拉列表中选择月销售收入来用美元,人民币,日元和欧元货币表示。 根据货币汇率,每月更新收入数字。 另外,每当货币汇率更新时,收入数字就会动态更新。

代码

此示例代码实现格式字符串,以根据不同货币的汇率更新销售收入。

var spread = new GC.Spread.Sheets.Workbook(document.getElementById('ss'), {
    sheetCount: 1
});
initSpread(spread);
};

function initSpread(spread) {
var gcns = GC.Spread.Sheets;
spread.suspendPaint();
var sheet = spread.getActiveSheet();
var data = [
    [, "FY 2019"],
    [, "Sales"],
    [, "Monthly", "Cumulative"],
    ["Apr", 188897, 188897],
    ["May", 208146, 397043],
    ["Jun", 226196, 623239],
    ["Jul", 277318, 900557],
    ["Aug", 263273, 1163830],
    ["Sep", 259845, 1423675],
    ["Oct", 241047, 1664722],
    ["Nov", 256306, 1921028],
    ["Dec", 195845, 2116873],
    ["Jan", 204934, 2321808],
    ["Feb", 257852, 2579660],
    ["Mar", 227779, 2807439]
];
sheet.setArray(3, 1, data);
sheet.setColumnWidth(2, 110);
sheet.setColumnWidth(3, 110);
sheet.setRowCount(20);
sheet.setColumnCount(9);
sheet.options.gridline.showHorizontalGridline = false;
sheet.options.gridline.showVerticalGridline = false;
sheet.getRange(3, 1, 15, 3).setBorder(
    new gcns.LineBorder("black", gcns.LineStyle.medium),
    { all: true });
sheet.addSpan(3, 2, 1, 2);
sheet.addSpan(4, 2, 1, 2);
sheet.getRange(3, 2, 3, 2).backColor('#CFE1F3').hAlign(gcns.HorizontalAlign.center);
sheet.getRange(6, 1, 12, 1).backColor('#CCC1DA');

var cMapSource = [
    { "Currency": "USD", "Value": 1, "Symbol": "$" },
    { "Currency": "CNY", "Value": 7.02, "Symbol": "¥" },
    { "Currency": "JPY", "Value": 108.8, "Symbol": "¥" },
    { "Currency": "EURO", "Value": 0.91, "Symbol": "€" },
];
sheet.tables.addFromDataSource('cT', 3, 5, cMapSource);
[5, 6, 7].forEach((col) => { sheet.setColumnWidth(col, 80); });

sheet.getCell(1, 2).value("Unit:").hAlign(gcns.HorizontalAlign.right);
sheet.getRange(1, 3, 1, 1).backColor("yellow").setBorder(
    new gcns.LineBorder("blue", gcns.LineStyle.medium),
    { all: true });

var dv1 = gcns.DataValidation.createFormulaListValidator('=cT[[#Data], [Currency]]');
sheet.setDataValidator(1, 3, dv1);
sheet.getCell(1, 3).hAlign(gcns.HorizontalAlign.center).value("USD");

sheet.getRange(6, 2, 12, 2)
    .hAlign(gcns.HorizontalAlign.center)
    .formatter('=VLOOKUP($D$2,cT[#Data],3,FALSE)&"  "&TEXT(@*VLOOKUP($D$2,cT[#Data],2,FALSE),"###,###")');
spread.resumePaint();

场景3

考虑一种情况,其中显示仪表以指示当前的KPI状态。 定制的功能代表仪表KPI迷你图,该KPI迷你图设置为样式的格式程序。可以变更不同的参数(例如radiusRatio,targetValue和label marginBottom)以查看仪表KPI迷你图的动态变化。

代码

此示例代码实现了格式字符串,以基于单元格值更新KPI标尺值。

<script>
var GuageKPIType = {
    circle: 0,
    verticalBar: 1,
    horizontalBar: 2
};

function getFontHeight(font) {
    var htmlSpan = document.createElement('span');
    htmlSpan.style.font = font;
    htmlSpan.innerHTML = 'H';
    var fontHeight = htmlSpan.offsetHeight;
    return fontHeight;
}

function GaugeKPISparkline() {
    GC.Spread.Sheets.Sparklines.SparklineEx.call(this);
    this.CIRCLE_CENTER_RADIUS = 6;
    this.TARGET_VALUE_INCREMENT = 3;
    this.CURRENT_VALUE_INCREMENT = 5;
    this.CURRENT_VALUE_LINE_WIDTH = 4;
    this.DASH_LINE_SOLID_LENGTH = 2;
    this.DASH_LINE_EMPTY_LENGTH = 4;
    this.TEXT_MARGIN = 10;
    this.PAINT_PADDING = 6;
}
GaugeKPISparkline.prototype = new GC.Spread.Sheets.Sparklines.SparklineEx();
GaugeKPISparkline.prototype.createFunction = function () {
    var functionDescription = {
        description: 'This function returns a data set used for representing a gauge KPI sparkline',
        parameters: [
            {
                name: 'gaugeType'
            },
            {
                name: 'targetValue'
            },
            {
                name: 'targetValueFont'
            },
            {
                name: 'currentValue'
            },
            {
                name: 'currentValueFont'
            },
            {
                name: 'minValue'
            },
            {
                name: 'minValueFont'
            },
            {
                name: 'maxValue'
            },
            {
                name: 'maxValueFont'
            },
            {
                name: 'minAngle'
            },
            {
                name: 'maxAngle'
            },
            {
                name: 'radiusRatio'
            },
            {
                name: 'marginBottom'
            },
            {
                name: 'colorRange'
            },
            {
                name: '...'
            }
        ]
    };
    var func = new GC.Spread.CalcEngine.Functions.Function("GAUGEKPISPARKLINE", 5, 15, functionDescription);
    func.evaluate = function (args) {
        var retValue = {
            gaugeType: args[0],
            targetValue: args[1],
            targetValueFont: args[2],
            currentValue: args[3],
            currentValueFont: args[4],
            minValue: args[5],
            minValueFont: args[6],
            maxValue: args[7],
            maxValueFont: args[8],
            minAngle: args[9],
            maxAngle: args[10],
            radiusRatio: args[11],
            marginBottom: args[12]
        };
        var ranges = [], argsLength = args.length, tempArray;
        for (var index = 13; index < argsLength; index++) {
            var rangeValue = args[index];
            if (rangeValue instanceof GC.Spread.CalcEngine.CalcArray) {
                tempArray = rangeValue.array[0];
                ranges.push({
                    start: tempArray[0],
                    end: tempArray[1],
                    color: tempArray[2]
                });
            }
        }
        retValue.ranges = ranges;
        return retValue;
    };
    func.acceptsArray = function (argIndex) {
        return argIndex >= 9 || argIndex >= 1 && argIndex <= 4;
    };
    return func;
};
GaugeKPISparkline.prototype.paint = function (ctx, value, x, y, width, height, options) {
    if (!value) {
        return;
    }
    if (value.gaugeType === GuageKPIType.circle) {
        ctx.save();
        ctx.rect(x, y, width, height);
        ctx.clip();
        this.paintCircle(ctx, value, x, y, width, height, options);
        ctx.restore();
    }
};
GaugeKPISparkline.prototype.getCircleData = function (ctx, value, x, y, width, height, options) {
    var zoomFactor = options.zoomFactor;
    var currentValueHeight = getFontHeight(value.currentValueFont) * zoomFactor,
        targetValueHeight = getFontHeight(value.targetValueFont) * zoomFactor;
    var PAINT_PADDING = this.PAINT_PADDING, TEXT_MARGIN = this.TEXT_MARGIN;
    var minAngle = value.minAngle, maxAngle = value.maxAngle;
    var minValueWidth = Math.ceil(ctx.measureText(value.minValue).width),
        maxValueWidth = Math.ceil(ctx.measureText(value.maxValue).width);
    var textWidth = Math.max(minValueWidth, maxValueWidth);
    var xOuterRadius = Math.floor(width / 2 - PAINT_PADDING - TEXT_MARGIN - textWidth);
    var graphHeight = Math.floor(height - PAINT_PADDING * 2 - TEXT_MARGIN * 2 - currentValueHeight - targetValueHeight),
        moreThanSemiCircle = Math.abs(minAngle) > 90 || Math.abs(maxAngle) > 90;
    var yOuterRadius = moreThanSemiCircle ? graphHeight / 2 : graphHeight;
    var outerRadius = Math.min(xOuterRadius, yOuterRadius);
    var retValue = {
        x: x + PAINT_PADDING + textWidth + TEXT_MARGIN + outerRadius,
        y: y + PAINT_PADDING + targetValueHeight + TEXT_MARGIN + outerRadius,
        outerRadius: outerRadius,
        innerRadius: outerRadius * value.radiusRatio
    };
    retValue.currentValuePoint = {
        x: retValue.x,
        y: moreThanSemiCircle ? (retValue.y + outerRadius + TEXT_MARGIN + currentValueHeight) : (retValue.y + TEXT_MARGIN + currentValueHeight)
    };
    return retValue;
};
GaugeKPISparkline.prototype.getPaintData = function (value) {
    var minRadian = (value.minAngle - 90) * Math.PI / 180, maxRadian = (value.maxAngle - 90) * Math.PI / 180;
    var minValue = value.minValue, maxValue = value.maxValue;
    var colorRanges = value.ranges, fillColor = 'lightgrey';
    var valuePerRadian = (maxRadian - minRadian) / (maxValue - minValue);
    var paintRanges = [];
    if (colorRanges.length > 0) {
        colorRanges.forEach(function (colorRange) {
            paintRanges.push({
                start: valuePerRadian * (colorRange.start - minValue) + minRadian,
                end: valuePerRadian * (colorRange.end - minValue) + minRadian,
                color: colorRange.color
            });
        });
        paintRanges.unshift({ start: minRadian, end: paintRanges[0].start, color: fillColor });
        paintRanges.push({ start: paintRanges[paintRanges.length - 1].end, end: maxRadian, color: fillColor });
    } else {
        paintRanges.push({ start: minRadian, end: maxRadian, color: fillColor });
    }
    return {
        paintRanges: paintRanges,
        fillColor: fillColor,
        targetValueRadian: valuePerRadian * (value.targetValue - minValue) + minRadian,
        currentValueRadian: valuePerRadian * (value.currentValue - minValue) + minRadian,
        minValueRadian: minRadian,
        maxValueRadian: maxRadian
    };
};
GaugeKPISparkline.prototype.getPointOnCircle = function (x, y, radian, radius) {
    return {
        x: x + Math.cos(radian) * radius,
        y: y + Math.sin(radian) * radius
    };
};
GaugeKPISparkline.prototype.getCircleValuePaintInfo = function (circleCenterPoint, targetValuePoint, targetValueWidth) {
    var TEXT_MARGIN = this.TEXT_MARGIN;
    // TODO:考虑文字高度
        if (targetValuePoint.x > circleCenterPoint.x) {
        return { x: targetValuePoint.x + TEXT_MARGIN, y: targetValuePoint.y, textAlign: 'left' };
    }
    if (targetValuePoint.x < circleCenterPoint.x) {
        return { x: targetValuePoint.x - TEXT_MARGIN, y: targetValuePoint.y, textAlign: 'right' };
    }
    if (targetValuePoint.x === circleCenterPoint.x) {
        if (targetValuePoint.y > circleCenterPoint.y) {
            return { x: targetValuePoint.x, y: targetValuePoint.y + TEXT_MARGIN, textAlign: 'center' };
        }
        return { x: targetValuePoint.x, y: targetValuePoint.y - TEXT_MARGIN, textAlign: 'center' };
    }
    return { x: targetValuePoint.x, y: targetValuePoint.y, textAlign: 'left' };
};
GaugeKPISparkline.prototype.paintCircle = function (ctx, value, x, y, width, height, options) {
    var zoomFactor = options.zoomFactor;
    var circleData = this.getCircleData(ctx, value, x, y, width, height, options);
    var innerRadius = circleData.innerRadius, outerRadius = circleData.outerRadius;
    if (outerRadius <= 0) {
        return;
    }
    var currentValuePoint = circleData.currentValuePoint;
    var circleCenter = { x: circleData.x, y: circleData.y };
    var paintData = this.getPaintData(value),
        paintRanges = paintData.paintRanges, fillColor = paintData.fillColor;

    ctx.save();

    // <editor-folder desc="paint circles">
        paintRanges.forEach(function (paintRange) {
        // 绘制外圈
            ctx.beginPath();
        ctx.moveTo(circleCenter.x, circleCenter.y);
        ctx.fillStyle = paintRange.color || fillColor;
        ctx.strokeStyle = 'white';
        ctx.arc(circleCenter.x, circleCenter.y, outerRadius, paintRange.start, paintRange.end, false);
        ctx.closePath();
        ctx.fill();
        ctx.stroke();

        // 绘制内圈
            ctx.beginPath();
        ctx.moveTo(circleCenter.x, circleCenter.y);
        ctx.fillStyle = 'white';
        ctx.strokeStyle = 'white';
        ctx.arc(circleCenter.x, circleCenter.y, innerRadius, paintRange.start, paintRange.end, false);
        ctx.closePath();
        ctx.fill();
        ctx.stroke();
    });
    // </editor-folder>

    // <editor-folder desc="paint circle center">
        ctx.beginPath();
    ctx.moveTo(circleCenter.x, circleCenter.y);
    ctx.fillStyle = 'black';
    ctx.arc(circleCenter.x, circleCenter.y, this.CIRCLE_CENTER_RADIUS, 0, 2 * Math.PI, false);
    ctx.fill();
    // </editor-folder>

    // <editor-folder desc="paint line">
        // <editor-folder desc="paint target value line">
        var targetValueInnerPointOnCircle = this.getPointOnCircle(circleCenter.x, circleCenter.y, paintData.targetValueRadian, innerRadius);
    var targetValueOuterPointOnCircle = this.getPointOnCircle(circleCenter.x, circleCenter.y, paintData.targetValueRadian, outerRadius + this.TARGET_VALUE_INCREMENT);
    ctx.save();
    ctx.beginPath();
    ctx.setLineDash([this.DASH_LINE_SOLID_LENGTH, this.DASH_LINE_EMPTY_LENGTH]);
    ctx.moveTo(targetValueInnerPointOnCircle.x, targetValueInnerPointOnCircle.y);
    ctx.strokeStyle = 'grey';
    ctx.lineTo(targetValueOuterPointOnCircle.x, targetValueOuterPointOnCircle.y);
    ctx.stroke();
    ctx.restore();
    // </editor-folder>

    // <editor-folder desc="paint current value line">
        var currentValuePointOnCircle = this.getPointOnCircle(circleCenter.x, circleCenter.y, paintData.currentValueRadian, outerRadius + this.CURRENT_VALUE_INCREMENT);
    ctx.beginPath();
    ctx.strokeStyle = 'black';
    ctx.lineWidth = this.CURRENT_VALUE_LINE_WIDTH;
    ctx.moveTo(circleCenter.x, circleCenter.y);
    ctx.lineTo(currentValuePointOnCircle.x, currentValuePointOnCircle.y);
    ctx.stroke();
    // </editor-folder>
        // </editor-folder>

    // <editor-folder desc="paint value">
        ctx.save();
    ctx.beginPath();
    ctx.textAlign = "start";
    ctx.fillStyle = 'grey';
    var minValueHeight = getFontHeight(value.minValueFont) * zoomFactor,
        maxValueHeight = getFontHeight(value.maxValueFont) * zoomFactor;
    var minMaxValueHeight = Math.floor(Math.max(minValueHeight, maxValueHeight));
    // <editor-folder desc="paint min value">
        var minValueFont = value.minValueFont || '10px Calibri';
    ctx.font = minValueFont;
    var minValue = value.minValue + '';
    var minValueWidth = ctx.measureText(minValue).width;
    var minValuePointOnCircle = this.getPointOnCircle(circleCenter.x, circleCenter.y, paintData.minValueRadian, outerRadius);
    var minValueInfo = this.getCircleValuePaintInfo(circleCenter, minValuePointOnCircle, minValueWidth);
    ctx.textAlign = minValueInfo.textAlign;
    ctx.fillText(minValue, minValueInfo.x, minValueInfo.y + minMaxValueHeight / 2);
    // </editor-folder>

    // <editor-folder desc="paint max value">
        var maxValueFont = value.maxValueFont || '30px Calibri';
    ctx.font = maxValueFont;
    var maxValue = value.maxValue + '';
    var maxValueWidth = ctx.measureText(maxValue).width;
    var maxValuePointOnCircle = this.getPointOnCircle(circleCenter.x, circleCenter.y, paintData.maxValueRadian, outerRadius);
    var maxValueInfo = this.getCircleValuePaintInfo(circleCenter, maxValuePointOnCircle, maxValueWidth);
    ctx.textAlign = maxValueInfo.textAlign;
    ctx.fillText(maxValue, maxValueInfo.x, maxValueInfo.y + minMaxValueHeight / 2);
    // </editor-folder>

    // <editor-folder desc="paint target value">
        var targetValueFont = value.targetValueFont || '16.667px Calibri';
    ctx.font = targetValueFont;
    var targetValue = value.targetValue + '';
    var targetValueWidth = ctx.measureText(targetValue).width;
    var targetValueInfo = this.getCircleValuePaintInfo(circleCenter, targetValueOuterPointOnCircle, targetValueWidth);
    ctx.textAlign = targetValueInfo.textAlign;
    ctx.fillText(targetValue, targetValueInfo.x, targetValueInfo.y);
    ctx.restore();
    // </editor-folder>

    // <editor-folder desc="paint current value">
        ctx.save();
    ctx.beginPath();
    var currentValueFont = value.currentValueFont || "25px Calibri";
    ctx.font = currentValueFont;
    var currentValue = value.currentValue + '';
    ctx.textAlign = "center";
    ctx.fillText(currentValue, currentValuePoint.x, currentValuePoint.y - value.marginBottom);
    ctx.restore();
    // </editor-folder>
        // </editor-folder>

    ctx.restore();
};
GaugeKPISparkline.prototype.paintHorizontalBar = function (ctx, value, x, y, width, height) {
    // ...
    };
GaugeKPISparkline.prototype.paintVerticalBar = function (ctx, value, x, y, width, height) {
    // ...
    };
</script>
<script>
$(document).ready(function () {
    // 初始化 Spread
        var spread = new GC.Spread.Sheets.Workbook(document.getElementById('ss'), { sheetCount: 1 });
    // KPI 测量
        var sheet1 = spread.getSheet(0);
    sheet1.name('KPI Gauge');
    spread.addSparklineEx(new GaugeKPISparkline());
    sheet1.suspendPaint();
    sheet1.setRowHeight(0, 300);
    sheet1.setColumnWidth(0, 300);
    sheet1.setColumnWidth(1, 300);
    sheet1.setColumnWidth(2, 300);
    sheet1.setRowCount(4);
    sheet1.setRowHeight(3, 300);
    sheet1.setColumnCount(3);
    sheet1.getCell(1, 0).text("radiusRatio").hAlign(2);
    sheet1.getCell(1, 1).text("targetValue").hAlign(2);
    sheet1.getCell(1, 2).text("label marginBottom").hAlign(2);
    var radiusRatioSliderStyle = new GC.Spread.Sheets.Style();
    radiusRatioSliderStyle.cellButtons = [{
        imageType: GC.Spread.Sheets.ButtonImageType.dropdown,
        command: "openSlider",
        useButtonStyle: true,
    }];
    radiusRatioSliderStyle.dropDowns = [{
        type: GC.Spread.Sheets.DropDownType.slider,
        option: {
            marks: [0, 50, 100],
            step: 1,
            width: 190,
            direction: GC.Spread.Sheets.LayoutDirection.horizontal,
        }
    }];
    var targetValueSliderStyle = new GC.Spread.Sheets.Style();
    targetValueSliderStyle.cellButtons = [{
        imageType: GC.Spread.Sheets.ButtonImageType.dropdown,
        command: "openSlider",
        useButtonStyle: true,
    }];
    targetValueSliderStyle.dropDowns = [{
        type: GC.Spread.Sheets.DropDownType.slider,
        option: {
            max: 40,
            marks: [0, 20, 40],
            step: 1,
            width: 190,
            direction: GC.Spread.Sheets.LayoutDirection.horizontal,
        }
    }];
    var marginBottomSliderStyle = new GC.Spread.Sheets.Style();
    marginBottomSliderStyle.cellButtons = [{
        imageType: GC.Spread.Sheets.ButtonImageType.dropdown,
        command: "openSlider",
        useButtonStyle: true,
    }];
    marginBottomSliderStyle.dropDowns = [{
        type: GC.Spread.Sheets.DropDownType.slider,
        option: {
            max: 50,
            marks: [0, 25, 50],
            step: 1,
            width: 190,
            direction: GC.Spread.Sheets.LayoutDirection.horizontal,
        }
    }];
    sheet1.setStyle(2, 0, radiusRatioSliderStyle);
    sheet1.setValue(2, 0, 50);
    sheet1.setStyle(2, 1, targetValueSliderStyle);
    sheet1.setValue(2, 1, 20);
    sheet1.setStyle(2, 2, marginBottomSliderStyle);
    sheet1.setValue(2, 2, 50);
    var style1 = new GC.Spread.Sheets.Style();
    style1.formatter =
        '=GAUGEKPISPARKLINE(0, 125000, "bold 18px Calibri", @, "bold 35px Calibri", 0, "12px Calibri", 150000, "12px Calibri", -90, 90, =A3/100, 0, {0, 39848, "#e14d57"})';
    sheet1.setStyle(0, 0, style1);
    sheet1.setValue(0, 0, 39848);
    sheet1.getCell(3, 0).value(style1.formatter.substr(1, style1.formatter.length - 1)).wordWrap(true);
    var style2 = new GC.Spread.Sheets.Style();
    style2.formatter =
        '=GAUGEKPISPARKLINE(0, B3, "bold 18px Calibri", @, "bold 35px Calibri", 0, "12px Calibri", 40, "12px Calibri", -75, 75, 0.3, 10, {0, 32.2, "#71b37c"})';
    sheet1.setStyle(0, 1, style2);
    sheet1.setValue(0, 1, 32.2);
    sheet1.getCell(3, 1).value(style2.formatter.substr(1, style2.formatter.length - 1)).wordWrap(true);
    var style3 = new GC.Spread.Sheets.Style();
    style3.formatter =
        '=GAUGEKPISPARKLINE(0, 0, "bold 18px Calibri", @, "bold 35px Calibri", -50, "12px Calibri", 50, "12px Calibri", -135, 135, 0.3, C3, {-21, 0, "#5290e9"})';
    sheet1.setStyle(0, 2, style3);
    sheet1.setValue(0, 2, -21);
    sheet1.getCell(3, 2).value(style3.formatter.substr(1, style3.formatter.length - 1)).wordWrap(true);
    sheet1.resumePaint();
    });
</script>

局限性

  • Excel不支持格式字符串。 因此,不支持excel I/O。
  • 格式字符串不支持单元格状态。