SpreadJS add the function SJS.TABLE to get the What-If Analysis Data Table results.
The SJS.TABLE function simulates inputting the value from inputs into input_cell , and then retrieves the value from result reference as the SJS.TABLE function result.
Argument
Description
result_reference
The cell location to retrieve the value. When all inputs are rows, it can be a range of 1 row and multiple columns. vice versa.
inputs
The values to input into input_cell. It can be a reference, an array, or a value.
input_cell
The cell to input the value. Must be a cell reference.
SJS.TABLE can completely cover traditional Data Table
Scenario
Traditional Data Table
Use SJS.TABLE
one-variable data table
Create DataTable A2:C10with column cell reference A2
B3: =SJS.TABLE(B2:C2,A3:A10,A2)
one-variable data table
Create DataTable A2:H5with row cell reference A2
B3: =SJS.TABLE(A3:A5,B2:H2,A2)
two-variable data table
Create DataTable A2:H5 with column cellreference A1 and row cell reference B1
B3: =SJS.TABLE(A2,B2:H2,B1,A3:A5,A1)
The What-If Analysis Data Table from Excel file will be transformed to SJS.TABLE function formula when importing.
When exporting to Excel, it attempts to convert to an Excel data table; if this fails, the formulas will be preserved.
SJS.TABLE is flexible
SJS.TABLE can use the various input
SJS.TABLE can use as the function parameter
import * as React from 'react';
import { createRoot } from 'react-dom/client';
import './styles.css';
import { AppFunc } from './app-func';
// Functional Component sample
createRoot(document.getElementById('app')).render(<AppFunc />);
import * as React from 'react';
import GC from '@mescius/spread-sheets';
import '@mescius/spread-sheets-io';
import '@mescius/spread-sheets-calc-worker';
import { SpreadSheets, Worksheet } from '@mescius/spread-sheets-react';
import './styles.css';
const useState = React.useState;
const useRef = React.useRef;
function isSJSFile(file) {
const fileName = file.name.toLowerCase();
return fileName.endsWith('.sjs');
}
export function AppFunc() {
const [spread, setSpread] = useState(null);
const [result, setResult] = useState('');
const [resultClass, setResultClass] = useState('');
const [calcMode, setCalcMode] = useState(0);
const [exportFormat, setExportFormat] = useState('ssjson');
const fileInputRef = useRef(null);
const initSpread = (spread) => {
setSpread(spread);
// Add status bar
const statusBar = new GC.Spread.Sheets.StatusBar.StatusBar(document.getElementById('statusBar'));
statusBar.bind(spread);
// Load data from datatable.js
spread.fromJSON(window.datatable);
}
const handleImport = () => {
fileInputRef.current.click();
}
const handleFileChange = (e) => {
const file = e.target.files[0];
if (!file) return;
const options = {
openMode: 2, // incremental loading
fullRecalc: true,
dynamicReferences: false,
incrementalCalculation: true
};
try {
if (isSJSFile(file)) {
spread.open(file, () => {
setResult('File imported successfully!');
setResultClass('success');
setTimeout(() => {
setResult('');
setResultClass('');
}, 2000);
}, (error) => {
setResult('Error importing file: ' + (error.errorMessage || error.message));
setResultClass('error');
}, options);
} else {
spread.import(file, () => {
setResult('File imported successfully!');
setResultClass('success');
setTimeout(() => {
setResult('');
setResultClass('');
}, 2000);
}, (error) => {
setResult('Error importing file: ' + (error.errorMessage || error.message));
setResultClass('error');
}, options);
}
} catch (error) {
setResult('Error importing file: ' + error.message);
setResultClass('error');
}
e.target.value = '';
}
const handleExport = () => {
try {
const fileName = "export." + exportFormat;
if (exportFormat === "sjs") {
spread.save((blob) => {
const url = URL.createObjectURL(blob);
const a = document.createElement('a');
a.href = url;
a.download = fileName;
a.click();
URL.revokeObjectURL(url);
setResult('File exported successfully!');
setResultClass('success');
setTimeout(() => {
setResult('');
setResultClass('');
}, 2000);
}, (error) => {
setResult('Error exporting file: ' + (error.errorMessage || error.message));
setResultClass('error');
});
} else {
const options = { fileType: exportFormat === "ssjson" ? GC.Spread.Sheets.FileType.ssjson : GC.Spread.Sheets.FileType.excel };
spread.export((blob) => {
const url = URL.createObjectURL(blob);
const a = document.createElement('a');
a.href = url;
a.download = fileName;
a.click();
URL.revokeObjectURL(url);
setResult('File exported successfully!');
setResultClass('success');
setTimeout(() => {
setResult('');
setResultClass('');
}, 2000);
}, (error) => {
setResult('Error exporting file: ' + (error.errorMessage || error.message));
setResultClass('error');
}, options);
}
} catch (error) {
setResult('Error exporting file: ' + error.message);
setResultClass('error');
}
}
const handleCalcModeChange = (mode) => {
setCalcMode(mode);
if (spread) {
spread.options.calculationMode = mode;
if (mode === 0) {
spread.calculate();
setResult('Calculation mode changed to: Automatic');
setResultClass('success');
} else if (mode === 2) { // partial - calc formulas except for data table
spread.suspendCalcService();
spread.resumeCalcService();
setResult('Calculation mode changed to: Partial');
setResultClass('success');
} else if (mode === 1) {
setResult('Calculation mode changed to: Manual');
setResultClass('success');
}
setTimeout(() => {
setResult('');
setResultClass('');
}, 2000);
}
}
const handleCalculateNow = () => {
try {
if (spread) {
spread.calculate();
setResult('Calculation completed!');
setResultClass('success');
setTimeout(() => {
setResult('');
setResultClass('');
}, 2000);
}
} catch (error) {
setResult('Error calculating: ' + error.message);
setResultClass('error');
}
}
return <div className="sample-tutorial">
<div className="sample-container">
<div className="sample-spreadsheets">
<SpreadSheets workbookInitialized={spread => initSpread(spread)}>
<Worksheet>
</Worksheet>
</SpreadSheets>
</div>
<div id="statusBar"></div>
</div>
<Panel
result={result}
resultClass={resultClass}
calcMode={calcMode}
exportFormat={exportFormat}
setExportFormat={setExportFormat}
fileInputRef={fileInputRef}
handleImport={handleImport}
handleExport={handleExport}
handleFileChange={handleFileChange}
handleCalcModeChange={handleCalcModeChange}
handleCalculateNow={handleCalculateNow}
/>
</div>;
}
function Panel(props) {
return (
<div className="options-container">
<div className="option-row">
<label>Import / Export:</label>
<input type="file" ref={props.fileInputRef} accept=".ssjson,.sjs,.json,.xlsx" style={{display: 'none'}} onChange={props.handleFileChange} />
<input type="button" value="Import File" onClick={props.handleImport} />
<label htmlFor="exportFormat" style={{marginTop: '8px'}}>Export Format:</label>
<select id="exportFormat" value={props.exportFormat} onChange={(e) => props.setExportFormat(e.target.value)}>
<option value="ssjson">SSJSON</option>
<option value="sjs">SJS</option>
<option value="xlsx">Excel (XLSX)</option>
</select>
<input type="button" value="Export File" onClick={props.handleExport} />
</div>
<div className="option-row">
<label>Calculation Mode:</label>
<div className="radio-group">
<label className="radio-label">
<input type="radio" name="calcMode" value="0" checked={props.calcMode === 0} onChange={() => props.handleCalcModeChange(0)} /> Automatic
</label>
<label className="radio-label">
<input type="radio" name="calcMode" value="2" checked={props.calcMode === 2} onChange={() => props.handleCalcModeChange(2)} /> Partial
</label>
<label className="radio-label">
<input type="radio" name="calcMode" value="1" checked={props.calcMode === 1} onChange={() => props.handleCalcModeChange(1)} /> Manual
</label>
</div>
<input type="button" value="Calculate Now" onClick={props.handleCalculateNow} />
</div>
<div className="option-row">
<label>Result:</label>
<div className="result-container">
<div className={props.resultClass}>{props.result}</div>
</div>
</div>
</div>
)
}
<!doctype html>
<html style="height:100%;font-size:14px;">
<head>
<meta charset="utf-8" />
<meta name="viewport" content="width=device-width, initial-scale=1.0" />
<link rel="stylesheet" type="text/css" href="$DEMOROOT$/en/react/node_modules/@mescius/spread-sheets/styles/gc.spread.sheets.excel2013white.css">
<!-- SystemJS -->
<script src="$DEMOROOT$/en/react/node_modules/systemjs/dist/system.src.js"></script>
<script src="$DEMOROOT$/spread/source/data/datatable.js" type="text/javascript"></script>
<script src="systemjs.config.js"></script>
<script>
System.import('$DEMOROOT$/en/lib/react/license.js').then(function () {
System.import('./src/app');
});
</script>
</head>
<body>
<div id="app"></div>
</body>
</html>
.sample-tutorial {
position: relative;
height: 100%;
overflow: hidden;
}
.sample-container {
width: calc(100% - 280px);
height: 100%;
float: left;
}
.sample-spreadsheets {
width: 100%;
height: calc(100% - 25px);
overflow: hidden;
}
#statusBar {
bottom: 0;
height: 25px;
width: 100%;
position: relative;
}
.options-container {
float: right;
width: 280px;
overflow: auto;
padding: 12px;
height: 100%;
box-sizing: border-box;
background: #fbfbfb;
}
.option-row {
margin-bottom: 12px;
}
.option-row label {
display: block;
margin-bottom: 4px;
font-weight: bold;
font-size: 12px;
}
input[type=text],
input[type=number] {
width: 100%;
padding: 6px;
border: 1px solid #ccc;
border-radius: 3px;
box-sizing: border-box;
}
select {
width: 100%;
padding: 6px;
margin-bottom: 6px;
border: 1px solid #ccc;
border-radius: 3px;
box-sizing: border-box;
font-size: 12px;
}
input[type=button] {
width: 100%;
padding: 8px 6px;
margin-bottom: 6px;
background: #007acc;
color: white;
border: none;
border-radius: 3px;
cursor: pointer;
font-weight: bold;
}
input[type=button]:hover {
background: #005a9e;
}
.result-container {
padding: 8px;
border-radius: 3px;
min-height: 40px;
}
.success {
background: #d4edda;
color: #155724;
padding: 8px;
border-radius: 3px;
}
.error {
background: #f8d7da;
color: #721c24;
padding: 8px;
border-radius: 3px;
}
.radio-group {
margin-bottom: 8px;
}
.radio-label {
display: block;
font-weight: normal;
font-size: 12px;
margin-bottom: 4px;
cursor: pointer;
}
.radio-label input[type="radio"] {
margin-right: 6px;
cursor: pointer;
}
body {
position: absolute;
top: 0;
bottom: 0;
left: 0;
right: 0;
}
#app {
height: 100%;
}
(function (global) {
System.config({
transpiler: 'plugin-babel',
babelOptions: {
es2015: true,
react: true
},
meta: {
'*.css': { loader: 'css' }
},
paths: {
// paths serve as alias
'npm:': 'node_modules/',
'cdn:': 'https://cdn.mescius.io/demoapps/packages/spreadjs/19.1.1-master-2026-05-28-1420/'
},
// map tells the System loader where to look for things
map: {
'@mescius/spread-sheets': 'cdn:@mescius/spread-sheets/index.js',
'@mescius/spread-sheets-io': 'cdn:@mescius/spread-sheets-io/index.js',
'@mescius/spread-sheets-calc-worker': 'cdn:@mescius/spread-sheets-calc-worker/index.js',
'@mescius/spread-sheets-react': 'cdn:@mescius/spread-sheets-react/index.js',
'@grapecity/jsob-test-dependency-package/react-components': 'npm:@grapecity/jsob-test-dependency-package/react-components/index.js',
'react': 'npm:react/cjs/react.production.js',
'react-dom': 'npm:react-dom/cjs/react-dom.production.js',
'react-dom/client': 'npm:react-dom/cjs/react-dom-client.production.js',
'scheduler': 'npm:scheduler/cjs/scheduler.production.js',
'css': 'npm:systemjs-plugin-css/css.js',
'plugin-babel': 'npm:systemjs-plugin-babel/plugin-babel.js',
'systemjs-babel-build':'npm:systemjs-plugin-babel/systemjs-babel-browser.js'
},
// packages tells the System loader how to load when no filename and/or no extension
packages: {
src: {
defaultExtension: 'jsx'
},
"node_modules": {
defaultExtension: 'js'
},
}
});
})(this);
