创建和使用自定义语言包

除了超过 18 个可用的语言包外，SpreadJS 还支持自定义本地化。

您可以自定义语言包并修改现有的语言包。根据您的特定偏好显示单词或短语。

使用自定义语言包

创建和使用自定义语言包非常有用，尤其是当用户在不同语言环境中工作时需要使用区域日期和时间格式时。

您可以本地化函数名称、使用自定义函数、定义表函数、自定义表公式关键字、CalcError 短语、布尔值，并使用首选语言处理特殊函数逻辑。

您可以使用culture()方法，addCultureInfo() 方法自定义语言包

如下所示

以下示例代码显示了如何使用自定义语言包。

<!DOCTYPE html>
<html>
<head>
<script src="https://code.jquery.com/jquery-2.1.1.min.js" type="text/javascript"></script>
<link href="css/gc.spread.sheets.excel2013white.12.2.0.css" rel="stylesheet" />
<script src="scripts/gc.spread.sheets.all.12.2.0.min.js"></script>
<script src="scripts/demo.js"></script>
<script src="scripts/resource.js"></script>
<script>
$(document).ready(function () {

// 初始化Spread
var spread = new GC.Spread.Sheets.Workbook(document.getElementById('ss'), { sheetCount: 1 });

// 获取sheet
sheet = spread.getSheet(0);
spread.suspendPaint();
spread.options.showScrollTip = 3;
spread.options.showResizeTip = 3;
var table = sheet.tables.addFromDataSource("table1", 0, 0, source, GC.Spread.Sheets.Tables.TableThemes.medium2)
table.showFooter(true);
table.showHeader(true);
table.highlightFirstColumn(true);
table.setColumnFormula(3, "=SUM(D4:D12)");
table.setColumnFormula(2, "=SUM(E4:E12)");
table.setColumnValue(0, "Total");
sheet.setColumnWidth(0, 130);
sheet.setColumnWidth(4, 100);
spread.resumePaint();
GC.Spread.Common.CultureManager.addCultureInfo("de", null, de);
GC.Spread.Common.CultureManager.addCultureInfo("zh_tw", null, zh_tw);
GC.Spread.Common.CultureManager.addCultureInfo("fr", null, fr);
GC.Spread.Common.CultureManager.addCultureInfo("ha_ha", null, ha_ha);
spread.resumePaint();
var select = document.getElementById('CultureSelect');
select.onchange = function ()
{
  debugger;
  var culture = this.value;
  GC.Spread.Common.CultureManager.culture(culture);
  $("#l_description").text(langDescription[culture]);
  $("#language").val(JSON.stringify(window[culture], null, 2));
}
});
</script>
</head>

<body>
<div id="settingsDiv">
Switch Culture:
<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>
</div>

<p id="l_description">The base and default language.</p>
<div id="ss" style="height:400px;width:600px"></div>
<textarea id="language" cols="85" rows="40" style="max-width: 98%" readonly="readonly"></textarea>
</body>
</html>

修改现有语言包

您可以自定义现有的语言包并将它们翻译成特定的语言。比如需要在spread中显示不同的文本。

您可以使用CultureManager.getResources方法来获取当前或指定的文化资源。此方法返回当前工作语言或指定的语言包。

获得语言包后，您可以按照以下步骤将修改后的包应用到Spread：

修改返回的语言包。
使用 addCultureInfo 方法将语言添加到 SpreadJS 中。
使用 CultureManager.culture 方法更改 SpreadJS 语言。

注意: 如果您通过 addCultureInfo 方法添加自定义语言，则无法立即获取此资源，直到使用 CultureManager.culture 方法将当前文化更改为自定义文化。

或者，您可以直接使用 CultureManager.getLanguage 方法。

下面的 GIF 说明了使用特定的中文字符串（宽度滚动提示）与日语语言包。

以下示例代码显示了如何修改和使用现有语言包。

// 配置工作簿和工作表
var spread = new GC.Spread.Sheets.Workbook("ss");
var sheet = spread.getActiveSheet();

// 显示行高和列宽的调整大小提示
spread.options.showResizeTip = GC.Spread.Sheets.ShowScrollTip.both;
// 获取指定语言
var originResources = GC.Spread.Common.CultureManager.getResources("ja-jp"); 
// 修改语言。
originResources.Sheets.Tip_Width = "宽度： {0} 像素"; 
GC.Spread.Common.CultureManager.addCultureInfo("custom", null, originResources);
GC.Spread.Common.CultureManager.culture("custom");