自定义本地化

SpreadJS 支持自定义本地化资源,允许开发者翻译界面文本、函数描述、提示信息等内容,实现多语言表格应用。通过自定义语言包,可以满足不同地区用户的语言需求,提升用户体验。

概述 本 Demo 展示了如何自定义 SpreadJS 的本地化资源,包括添加新的语言包、修改现有语言资源,以及动态切换语言。Demo 中演示了德语、法语、自定义中文等多种语言的自定义方式。 实现思路 初始化工作簿并加载表格数据,设置滚动提示和调整大小提示 从外部资源文件加载预定义的语言包(de、fr、ha_ha 等) 获取现有的中文语言资源,修改部分文本后创建自定义的 zh-tw 语言包 使用 CultureManager.addCultureInfo 方法添加各个语言包 监听下拉框的 change 事件,通过 CultureManager.culture 方法动态切换语言 代码解析 添加自定义语言包 使用 addCultureInfo 方法可以将自定义的语言包添加到 CultureManager 中。第一个参数是语言名称,第二个参数是 CultureInfo 对象(可选),第三个参数是语言资源对象。 修改现有语言资源 这段代码展示了如何获取现有的中文资源对象,修改其中的部分内容,然后创建一个新的 zh_tw 语言包。getResources 方法返回的是资源对象的引用,可以直接修改其属性。 动态切换语言 当用户选择不同的语言时,调用 CultureManager.culture() 方法切换当前语言,SpreadJS 会自动更新所有界面文本。 运行效果 页面加载后,表格显示默认的英文界面 点击下拉框选择不同语言,整个表格界面会立即切换为对应的语言 悬停或调整列宽时,提示信息会显示对应语言的文本 右侧文本框会显示当前语言包的完整 JSON 配置 支持切换的语言包括:英语、繁体中文、德语、法语 和自定义语言 API 参考 CultureManager.addCultureInfo(cultureName, culture?, language?) cultureName:语言名称,如 "zh-cn"、"en-us" culture:可选,CultureInfo 对象 language:可选,语言资源对象 CultureManager.culture(cultureName) cultureName:要切换到的语言名称 CultureManager.getResources(cultureName?) cultureName:可选,要获取的语言名称。不传则返回当前语言的资源 返回值:语言资源对象
var spreadNS = GC.Spread.Sheets; window.onload = function () { var spread = new GC.Spread.Sheets.Workbook(document.getElementById("ss"), {sheetCount: 1}); initSpread(spread); } function initSpread(spread) { var sheet = spread.getActiveSheet(); spread.suspendPaint(); spread.options.showScrollTip = 3; spread.options.showResizeTip = 3; var table = sheet.tables.addFromDataSource("table1", 0, 0, source, GC.Spread.Sheets.Tables.TableThemes.medium9) table.showFooter(true); table.showHeader(true); table.highlightFirstColumn(true); table.setColumnFormula(2, "=SUM(C2:C10)"); table.setColumnFormula(3, "=SUM(D2:D10)"); table.setColumnValue(0, "Total"); sheet.setColumnWidth(0, 130); sheet.setColumnWidth(4, 100); GC.Spread.Common.CultureManager.addCultureInfo("de", null, de); var zhResources = GC.Spread.Common.CultureManager.getResources("zh-cn"); zhResources.Sheets.Tip_Column = zh_tw.Sheet.Tip_Column; zhResources.Sheets.Tip_Height = zh_tw.Sheet.Tip_Height; zhResources.Sheets.Tip_Row = zh_tw.Sheet.Tip_Row; zhResources.Sheets.Tip_Width = zh_tw.Sheet.Tip_Width; zhResources.Sheets.NewTab = zh_tw.Sheet.NewTab; zhResources.StatusBar = zh_tw.StatusBar; zhResources.CalcEngine.Fbx_Summary = zh_tw.CalcEngine.Fbx_Summary; zhResources.Functions.SUM = zh_tw.Functions.SUM; zhResources.Functions.NOW = zh_tw.Functions.NOW; zhResources.Functions.IF = zh_tw.Functions.IF; GC.Spread.Common.CultureManager.addCultureInfo("zh_tw", null, zhResources); GC.Spread.Common.CultureManager.addCultureInfo("fr", null, fr); GC.Spread.Common.CultureManager.addCultureInfo("ha_ha", null, ha_ha); var statusBar = new GC.Spread.Sheets.StatusBar.StatusBar(document.getElementById('statusBar')); statusBar.bind(spread); spread.resumePaint(); var select = document.getElementById('CultureSelect'); select.addEventListener('change', function () { var culture = this.value; GC.Spread.Common.CultureManager.culture(culture); document.getElementById('l_description').innerText = langDescription[culture]; if (culture === "en") { document.getElementById('language').value = ""; } else if (culture === "zh_tw") { document.getElementById('language').value = JSON.stringify(GC.Spread.Common.CultureManager.getResources("zh_tw"), null, 2); } else { document.getElementById('language').value = JSON.stringify(window[culture], null, 2); } }); }
<!doctype html> <html style="height:100%;font-size:14px;"> <head> <meta charset="utf-8" /> <meta name="spreadjs culture" content="zh-cn" /> <meta name="viewport" content="width=device-width, initial-scale=1.0" /> <link rel="stylesheet" type="text/css" href="$DEMOROOT$/zh/purejs/node_modules/@grapecity-software/spread-sheets/styles/gc.spread.sheets.excel2013white.css"> <script src="$DEMOROOT$/zh/purejs/node_modules/@grapecity-software/spread-sheets/dist/gc.spread.sheets.all.min.js" type="text/javascript"></script> <script src="$DEMOROOT$/zh/purejs/node_modules/@grapecity-software/spread-sheets-resources-zh/dist/gc.spread.sheets.resources.zh.min.js" type="text/javascript"></script> <script src="$DEMOROOT$/spread/source/js/license.js" type="text/javascript"></script> <script src="$DEMOROOT$/spread/source/data/customLocalization.js" type="text/javascript"></script> <script src="app.js" type="text/javascript"></script> <link rel="stylesheet" type="text/css" href="styles.css"> </head> <body> <div class="sample-tutorial"> <div class="sample-container"> <div id="ss" class="sample-spreadsheets"></div> <div id="statusBar"></div> </div> <div class="sample-options"> <div class="options-container"> 切换语言: <select id="CultureSelect"> <option value="en">en</option> <option value="zh_tw">zh-tw</option> <option value="fr">fr</option> <option value="de">de</option> <option value="ha_ha">Ha-Ha</option> </select> <p id="l_description">将所有工作表属性的英文定义为基准和默认语言。</p> <textarea id="language" cols="85" rows="40" style="max-width: 98%; height: 465px" readonly="readonly"></textarea> <div class="sample-options"> <div class="options-container"> </div> </div> </div> </div> </div> </body> </html>
* { -webkit-tap-highlight-color: rgba(0, 0, 0, 0); } .sample-options { float: right; height: 100%; } .options-toggle { display: none; } .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; padding: 12px; box-sizing: border-box; background: #fbfbfb; overflow: auto; } .option-row { font-size: 14px; padding: 5px; margin-top: 10px; } label { display: block; margin-bottom: 6px; } input { padding: 4px 6px; box-sizing: border-box; width: 100%; } input[type=button] { margin-top: 6px; display: block; } .summary { background-color: #e6e6fa; padding: 3px; } body { position: absolute; top: 0; bottom: 0; left: 0; right: 0; }