概述
本 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;
}