Language Package

SpreadJS supports calculation engine packages that provide a way to use formulas in different languages.

To use language, you need to import the resource js file as follows: You can use following code to switch language package When you want to change another language, please recalculate the spread formula by calling the following code: Language Package Effection Function name resource like 'SUM' will changes to 'SOMME' in French. Table function name resource like '#ALL, #Data' will changes to '#Tout, #Données' in French. Special function logic like 'LENB' will be different result in different language. CalcError name resource like '#NULL!' will be '#NOM?' in French. Boolean value resource like 'FALSE' will be 'FAUX' in French.
import * as React from 'react'; import { createRoot } from 'react-dom/client'; import './styles.css'; import { AppFunc } from './app-func'; import { App } from './app-class'; // 1. Functional Component sample createRoot(document.getElementById('app')).render(<AppFunc />); // 2. Class Component sample // createRoot(document.getElementById('app')).render(<App />);
import * as React from 'react'; import GC from '@mescius/spread-sheets'; import '@mescius/spread-sheets-languagepackages'; import { SpreadSheets, Worksheet } from '@mescius/spread-sheets-react'; import './styles.css'; const useState = React.useState; export function AppFunc() { const [spread,setSpread]=useState(null); const initSpread =(spread)=> { setSpread(spread); var sheet = spread.getActiveSheet(); spread.suspendPaint(); sheet.setColumnWidth(0, 20); sheet.setColumnWidth(1, 130); sheet.setColumnWidth(2, 70); sheet.setColumnWidth(3, 70); sheet.setColumnWidth(4, 70); sheet.setColumnWidth(5, 100); var source = [ { Course: "Calculus", Term: 1, Credit: 5, Score: 80, Teacher: "Nancy Feehafer" }, { Course: "P.E.", Term: 1, Credit: 3.5, Score: 85, Teacher: "Andrew Cencini" }, { Course: "Political Economics", Term: 1, Credit: 3.5, Score: 95, Teacher: "Jan Kotas" }, { Course: "Basic of Computer", Term: 1, Credit: 2, Score: 85, Teacher: "Steven Thorpe" }, { Course: "Micro-Economics", Term: 1, Credit: 4, Score: 62, Teacher: "Jan Kotas" }, { Course: "Linear Algebra", Term: 2, Credit: 5, Score: 73, Teacher: "Nancy Feehafer" }, { Course: "Accounting", Term: 2, Credit: 3.5, Score: 86, Teacher: "Nancy Feehafer" }, { Course: "Statistics", Term: 2, Credit: 5, Score: 85, Teacher: "Robert Zare" }, { Course: "Marketing", Term: 2, Credit: 4, Score: 70, Teacher: "Laura Giussani" } ]; sheet.tables.addFromDataSource("Table1", 2, 1, source, GC.Spread.Sheets.Tables.TableThemes.medium7); sheet.setValue(0, 1, "Switch the language and check the SUM formula changes"); sheet.setValue(13, 2, "SUM:"); sheet.setFormula(13, 3, "=SUM(Table1[[#Data], [Credit]])"); sheet.setFormula(13, 4, "=FORMULATEXT(D14)"); sheet.getRange(13, 4, 1, 3) .foreColor("rgb(130, 188, 0)"); sheet.addSpan(13, 4, 1, 3); sheet.setValue(15, 2, "LENB:"); sheet.setFormula(15, 3, '=LENB("SpreadJS")'); sheet.setFormula(15, 4, "=FORMULATEXT(D16)"); sheet.getRange(15, 4, 1, 3) .foreColor("rgb(130, 188, 0)"); sheet.addSpan(15, 4, 1, 3); spread.resumePaint(); } const applyLanguage=(e) =>{ var languageName = e.target.value; GC.Spread.CalcEngine.LanguagePackages.languagePackages(languageName); spread.sheets[0].recalcAll(true); } return <div class="sample-tutorial"> <div class="sample-spreadsheets"> <SpreadSheets workbookInitialized={spread=>initSpread(spread)}> <Worksheet> </Worksheet> </SpreadSheets> </div> <Panel applyLanguage={(e)=>{applyLanguage(e)}} /> </div>; } function Panel(props){ return( <div class="options-container"> <div class="option-row"> Please choose one language from the drop-down list and check the localized function changes. <select id="languageSelect" class="drop-down-list" onChange={(e)=>{props.applyLanguage(e)}}> <option value="en">English</option> <option value="zh">China</option> <option value="ja">Japan</option> <option value="ko">Korea/Korean </option> <option value="fr">French</option> <option value="nl">Dutch</option> <option value="de">German</option> <option value="es">Spanish</option> <option value="pt">Portuguese</option> <option value="ru">Russian</option> <option value="sv">Swedish</option> <option value="it">Italian</option> <option value="da">Danish</option> <option value="pl">Polish</option> <option value="fi">Finnish</option> <option value="no">Norwegian</option> <option value="cs">Czech </option> <option value="hu">Hungarian</option> <option value="tr">Turkish</option> </select> </div> </div> ); }
import * as React from 'react'; import GC from '@mescius/spread-sheets'; import '@mescius/spread-sheets-languagepackages'; import { SpreadSheets, Worksheet } from '@mescius/spread-sheets-react'; import './styles.css'; const Component = React.Component; 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 applyLanguage={(e)=>{this.applyLanguage(e)}} /> </div>; } initSpread(spread) { this.spread = spread; var sheet = spread.getActiveSheet(); spread.suspendPaint(); sheet.setColumnWidth(0, 20); sheet.setColumnWidth(1, 130); sheet.setColumnWidth(2, 70); sheet.setColumnWidth(3, 70); sheet.setColumnWidth(4, 70); sheet.setColumnWidth(5, 100); var source = [ { Course: "Calculus", Term: 1, Credit: 5, Score: 80, Teacher: "Nancy Feehafer" }, { Course: "P.E.", Term: 1, Credit: 3.5, Score: 85, Teacher: "Andrew Cencini" }, { Course: "Political Economics", Term: 1, Credit: 3.5, Score: 95, Teacher: "Jan Kotas" }, { Course: "Basic of Computer", Term: 1, Credit: 2, Score: 85, Teacher: "Steven Thorpe" }, { Course: "Micro-Economics", Term: 1, Credit: 4, Score: 62, Teacher: "Jan Kotas" }, { Course: "Linear Algebra", Term: 2, Credit: 5, Score: 73, Teacher: "Nancy Feehafer" }, { Course: "Accounting", Term: 2, Credit: 3.5, Score: 86, Teacher: "Nancy Feehafer" }, { Course: "Statistics", Term: 2, Credit: 5, Score: 85, Teacher: "Robert Zare" }, { Course: "Marketing", Term: 2, Credit: 4, Score: 70, Teacher: "Laura Giussani" } ]; sheet.tables.addFromDataSource("Table1", 2, 1, source, GC.Spread.Sheets.Tables.TableThemes.medium7); sheet.setValue(0, 1, "Switch the language and check the SUM formula changes"); sheet.setValue(13, 2, "SUM:"); sheet.setFormula(13, 3, "=SUM(Table1[[#Data], [Credit]])"); sheet.setFormula(13, 4, "=FORMULATEXT(D14)"); sheet.getRange(13, 4, 1, 3) .foreColor("rgb(130, 188, 0)"); sheet.addSpan(13, 4, 1, 3); sheet.setValue(15, 2, "LENB:"); sheet.setFormula(15, 3, '=LENB("SpreadJS")'); sheet.setFormula(15, 4, "=FORMULATEXT(D16)"); sheet.getRange(15, 4, 1, 3) .foreColor("rgb(130, 188, 0)"); sheet.addSpan(15, 4, 1, 3); spread.resumePaint(); } applyLanguage(e) { var languageName = e.target.value; GC.Spread.CalcEngine.LanguagePackages.languagePackages(languageName); this.spread.sheets[0].recalcAll(true); } } class Panel extends Component{ constructor(props){ super(props); } render(){ return( <div class="options-container"> <div class="option-row"> Please choose one language from the drop-down list and check the localized function changes. <select id="languageSelect" class="drop-down-list" onChange={(e)=>{this.props.applyLanguage(e)}}> <option value="en">English</option> <option value="zh">China</option> <option value="ja">Japan</option> <option value="ko">Korea/Korean </option> <option value="fr">French</option> <option value="nl">Dutch</option> <option value="de">German</option> <option value="es">Spanish</option> <option value="pt">Portuguese</option> <option value="ru">Russian</option> <option value="sv">Swedish</option> <option value="it">Italian</option> <option value="da">Danish</option> <option value="pl">Polish</option> <option value="fi">Finnish</option> <option value="no">Norwegian</option> <option value="cs">Czech </option> <option value="hu">Hungarian</option> <option value="tr">Turkish</option> </select> </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="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-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; } .drop-down-list { margin-top: 10px; } 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-languagepackages': 'npm:@mescius/spread-sheets-languagepackages/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/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);