사용자 정의 함수

SpreadJS에서는 자체 함수를 만들어 시트에 추가할 수 있습니다. 모든 500개 이상의 내장 함수 외에도, SpreadJS 계산 엔진을 통해 특정 비즈니스 활용 사례에 맞는 사용자 정의 기능을 만들 수 있습니다. 기본 제공 함수와 마찬가지로 정의 및 호출할 수 있습니다.

설명
app.jsx
app-func.jsx
app-class.jsx
index.html
styles.css

다음 코드와 같이 GC.Spread.CalcEngine.Functions.Function 상속을 통해 자신만의 함수를 만들 수 있습니다:

    function FactorialFunction() {
       this.name = 'FACTORIAL';
       this.maxArgs = 1;
       this.minArgs = 1;
    }
    FactorialFunction.prototype = new GC.Spread.CalcEngine.Functions.Function();
    FactorialFunction.prototype.evaluate = function (arg) {
       // your own evaluate content
    }
    var factorial = new FactorialFunction();
    sheet.addCustomFunction(factorial);

평가 함수는 다음 코드처럼 사용자 정의 함수가 배열을 반환함을 나타내는 GC.Spread.CalcEngine.CalcArray 개체를 반환할 수 있습니다.

    MyCustomFunction.prototype.evaluate = function (context) {
        return new GC.Spread.CalcEngine.CalcArray([[1, 2, 3]]);
    } 

사용자 고유의 함수를 추가한 후 해당 함수를 제거하거나 모든 사용자 정의 함수를 지우려면 removeCustomFunction 또는 clearCustomFunctions 메서드를 사용합니다.

    sheet.removeCustomFunction('FACTORIAL');
    sheet.clearCustomFunctions();
다음 코드와 같이 GC.Spread.CalcEngine.Functions.Function 상속을 통해 자신만의 함수를 만들 수 있습니다: 평가 함수는 다음 코드처럼 사용자 정의 함수가 배열을 반환함을 나타내는 GC.Spread.CalcEngine.CalcArray 개체를 반환할 수 있습니다. 사용자 고유의 함수를 추가한 후 해당 함수를 제거하거나 모든 사용자 정의 함수를 지우려면 removeCustomFunction 또는 clearCustomFunctions 메서드를 사용합니다.
import * as React from 'react'; import * as ReactDOM from 'react-dom'; import './styles.css'; import { AppFunc } from './app-func'; import { App } from './app-class'; // 1. Functional Component sample ReactDOM.render(<AppFunc />, document.getElementById('app')); // 2. Class Component sample // ReactDOM.render(<App />, document.getElementById('app'));
import * as React from 'react'; import GC from '@mescius/spread-sheets'; import '@mescius/spread-sheets-resources-ko'; GC.Spread.Common.CultureManager.culture("ko-kr"); import { SpreadSheets, Worksheet } from '@mescius/spread-sheets-react'; import './styles.css'; class FactorialFunction extends GC.Spread.CalcEngine.Functions.Function { constructor() { super("FACTORIAL", 1, 1); } evaluate(arg) { var result = 1; if (arguments.length === 1 && !isNaN(arg)) { for (var i = 1; i <= arg; i++) { result = i * result; } return result; } return "#VALUE!"; } } class FactorialArrayFunction extends GC.Spread.CalcEngine.Functions.Function { constructor() { super("FACTORIAL.ARRAY", 1, 1); } evaluate(arg) { let t = 1; let result = [[]]; if (arguments.length === 1 && !isNaN(arg)) { for (var i = 1; i <= arg; i++) { t = i * t; result[0].push(t); } return new GC.Spread.CalcEngine.CalcArray(result); } return "#VALUE!"; } } const useState = React.useState; const factorial = new FactorialFunction(); const factorialArray = new FactorialArrayFunction(); export function AppFunc() { const [spread, setSpread] = useState(null); const initSpread = (spread) => { setSpread(spread); spread.options.allowDynamicArray = true; var sheet = spread.getSheet(0); sheet.setValue(1, 1, 'Press \'Add a Custom Function\' button'); sheet.setColumnWidth(1, 225); sheet.setColumnWidth(2, 100); } const addCustomFunction = (e) => { var sheet = spread.sheets[0]; sheet.addCustomFunction(factorial); sheet.setValue(3, 1, 'Formula'); sheet.setValue(3, 2, '=FACTORIAL(5)'); sheet.setValue(4, 1, 'Result'); sheet.setFormula(4, 2, "=FACTORIAL(5)"); sheet.setValue(6, 1, 'Formula'); sheet.setValue(6, 2, '=FACTORIAL.ARRAY(5)'); sheet.setValue(7, 1, 'Result'); sheet.addCustomFunction(factorialArray); sheet.setFormula(7, 2, "=FACTORIAL.ARRAY(5)"); } const removeCustomFunction = (e) => { var sheet = spread.sheets[0]; sheet.removeCustomFunction("FACTORIAL"); sheet.removeCustomFunction("FACTORIAL.ARRAY"); sheet.recalcAll(true); } return <div class="sample-tutorial"> <div class="sample-spreadsheets"> <SpreadSheets workbookInitialized={spread => initSpread(spread)}> <Worksheet> </Worksheet> </SpreadSheets> </div> <Panel addCustomFunction={(e) => addCustomFunction(e)} removeCustomFunction={(e) => removeCustomFunction(e)} /> </div>; } function Panel(props) { return ( <div class="options-container"> <div class="option-row"> <input type="button" value="Add a Custom Function(factorial)" onClick={(e) => { props.addCustomFunction(e) }} /> <input type="button" value="Remove the Custom Function(factorial)" onClick={(e) => { props.removeCustomFunction(e) }} /> </div> </div> ) }
import * as React from 'react'; import GC from '@mescius/spread-sheets'; import '@mescius/spread-sheets-resources-ko'; GC.Spread.Common.CultureManager.culture("ko-kr"); import { SpreadSheets, Worksheet } from '@mescius/spread-sheets-react'; import './styles.css'; const Component = React.Component; class FactorialFunction extends GC.Spread.CalcEngine.Functions.Function { constructor() { super("FACTORIAL", 1, 1); } evaluate (arg) { var result = 1; if (arguments.length === 1 && !isNaN(arg)) { for (var i = 1; i <= arg; i++) { result = i * result; } return result; } return "#VALUE!"; } } class FactorialArrayFunction extends GC.Spread.CalcEngine.Functions.Function { constructor() { super("FACTORIAL.ARRAY", 1, 1); } evaluate (arg) { let t = 1; let result = [[]]; if (arguments.length === 1 && !isNaN(arg)) { for (var i = 1; i <= arg; i++) { t = i * t; result[0].push(t); } return new GC.Spread.CalcEngine.CalcArray(result); } return "#VALUE!"; } } export class App extends Component { constructor(props) { super(props); this.spread = null; } render() { return <div class="sample-tutorial"> <div class="sample-spreadsheets"> <SpreadSheets workbookInitialized={spread=>this.initSpread(spread)}> <Worksheet> </Worksheet> </SpreadSheets> </div> <Panel addCustomFunction={(e)=>{this.addCustomFunction(e)}} removeCustomFunction={(e)=>{this.removeCustomFunction(e)}} /> </div>; } initSpread(spread) { this.spread = spread; spread.options.allowDynamicArray = true; var sheet = spread.getSheet(0); sheet.setValue(1, 1, 'Press \'Add a Custom Function\' button'); sheet.setColumnWidth(1, 225); sheet.setColumnWidth(2, 100); this.factorial = new FactorialFunction(); this.factorialArray = new FactorialArrayFunction(); } addCustomFunction (e) { var sheet = this.spread.sheets[0]; sheet.addCustomFunction(this.factorial); sheet.setValue(3, 1, 'Formula'); sheet.setValue(3, 2, '=FACTORIAL(5)'); sheet.setValue(4, 1, 'Result'); sheet.setFormula(4, 2, "=FACTORIAL(5)"); sheet.setValue(6, 1, 'Formula'); sheet.setValue(6, 2, '=FACTORIAL.ARRAY(5)'); sheet.setValue(7, 1, 'Result'); sheet.addCustomFunction(this.factorialArray); sheet.setFormula(7, 2, "=FACTORIAL.ARRAY(5)"); } removeCustomFunction (e) { var sheet = this.spread.sheets[0]; sheet.removeCustomFunction("FACTORIAL"); sheet.removeCustomFunction("FACTORIAL.ARRAY"); sheet.recalcAll(true); } } class Panel extends Component{ constructor(props){ super(props); } render(){ return( <div class="options-container"> <div class="option-row"> <input type="button" value="Add a Custom Function(factorial)" onClick={(e)=>{this.props.addCustomFunction(e)}} /> <input type="button" value="Remove the Custom Function(factorial)" onClick={(e)=>{this.props.removeCustomFunction(e)}} /> </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$/ko/react/node_modules/@mescius/spread-sheets/styles/gc.spread.sheets.excel2013white.css"> <!-- SystemJS --> <script src="$DEMOROOT$/ko/react/node_modules/systemjs/dist/system.src.js"></script> <script src="systemjs.config.js"></script> <script> System.import('$DEMOROOT$/ko/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-spreadsheets { width: calc(100% - 280px); height: 100%; overflow: hidden; float: left; } .options-container { float: right; width: 280px; padding: 12px; height: 100%; box-sizing: border-box; background: #fbfbfb; overflow: auto; } .option-row { margin-bottom: 12px; } input[type=button] { padding: 4px 6px; margin-bottom: 6px; } 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/' }, // map tells the System loader where to look for things map: { '@mescius/spread-sheets': 'npm:@mescius/spread-sheets/index.js', '@mescius/spread-sheets-resources-ko': 'npm:@mescius/spread-sheets-resources-ko/index.js', '@mescius/spread-sheets-react': 'npm:@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/umd/react.production.min.js', 'react-dom': 'npm:react-dom/umd/react-dom.production.min.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);