カスタムローカライゼーション

カスタムローカライゼーションは、特定の言語でSpreadJSをカスタマイズする機能を提供します。 現在のカルチャまたは特定のカルチャの言語リソースを取得し、リソースをカスタマイズすることもできます。

説明
app.js
index.html
styles.css

この機能を使うには、スキーマを使用してローカライズオブジェクトを定義し、CultureManagerに追加してから、定義されたカルチャに切り替える必要があります。

ワークシートには、定義された単語とともに異なるプロパティが表示されます。

以下は、中国語でカスタマイズするサンプルです。

    var lang = {
        // ローカライズ設定
        Sheets: {
            Tip_Row: "行 = ",  // パラメータがない場合、行番号を追加します
            Tip_Column: "列 = ",
            Tip_Height: "高度: {0} 像素",   // パラメーターを使用する 
            Tip_Width: "寬度: {0} 像素",
        },
        CalcEngine: {
            Fbx_Summary: "概要"
        },
        Functions: {
            SUM: {
                description: "此函數返回某一單元格區域中所有數字之和。",
                parameters: ["值1", "值2"]
            },
            NOW: {
                description: "此函數返回當前的日期和時間。"
            },
            IF: {
                description: "使用邏輯函數 IF 函數時,如果條件為真,該函數將返回一個值;如果條件為假,函數將返回另一個值。",
                parameters: ["判断条件", "值1", "值2"]
            },
        }
    };

    GC.Spread.Common.CultureManager.addCultureInfo("zh-tw", null, lang);   // 言語の追加
    GC.Spread.Common.CultureManager.culture("zh-tw")    // カルチャの設定

または、特定のカルチャに基づいたリソースを修正します。

var originZHLang = GC.Spread.Common.CultureManager.getResources("zh-cn");
originZHLang.Sheets.Tip_Row = "行 = ";
originZHLang.Sheets.Tip_Column = "列 = ";
originZHLang.Sheets.Tip_Height = "高度: {0} 像素";
originZHLang.Sheets.Tip_Width = "寬度: {0} 像素";
originZHLang.CalcEngine.Fbx_Summary = "概要";
originZHLang.Functions.SUM = {
            description: "此函數返回某一單元格區域中所有數字之和。",
            parameters: ["值1", "值2"]
        };
originZHLang.Functions.NOW = {
            description: "此函數返回當前的日期和時間。"
        };
originZHLang.Functions.IF = {
            description: "使用邏輯函數 IF 函數時,如果條件為真,該函數將返回一個值;如果條件為假,函數將返回另一個值。",
            parameters: ["判断条件", "值1", "值2"]
        };
GC.Spread.Common.CultureManager.addCultureInfo("zh-tw", null, originZHLang);   //Add the language
GC.Spread.Common.CultureManager.culture("zh-tw")    //set the culture

使用時のヒント:

一部のステートメントが設定されていない場合、SpreadJSは英語を表示します(空の文字列 "" に設定されている場合、何も表示されません)。

引数は、表示に{0}、{1}、…を使用します(例:「無効な{0}:{1}({2}と{3}の間でなければなりません)。」、「高さ:{0}ピクセル」)。

カスタムローカライゼーションはfromJson / toJsonをサポートしていないため、ユーザーは必要になるたびに追加する必要があります。

サンプルのネームスペース(「common」、「Sheets」、「Filter」)はオプションです。 ただし、「Functions」と「TableFunctions」は必須です。 以下も有効な形式です。

    var lang = {
        Tip_Row: "行 = ",  //パラメータがない場合、行を追加します 
        Tip_Column: "列 = ",
        Tip_Height: "高度: {0} 像素",   // パラメーターを使用する 
        Tip_Width: "寬度: {0} 像素",
        CalcEngine: {  // CalcEngineはオプションで、Fbx_Summaryをlangオブジェクトに設定します
            Fbx_Summary: "概要"
        },
        Functions: { // 関数の説明をカスタマイズするには、「Functions」が必要です。
            SUM: {
                description: "此函數返回某一單元格區域中所有數字之和。",
                parameters: ["值1", "值2"]
            },
        }
    };
この機能を使うには、スキーマを使用してローカライズオブジェクトを定義し、CultureManagerに追加してから、定義されたカルチャに切り替える必要があります。 ワークシートには、定義された単語とともに異なるプロパティが表示されます。 以下は、中国語でカスタマイズするサンプルです。 または、特定のカルチャに基づいたリソースを修正します。 使用時のヒント: 一部のステートメントが設定されていない場合、SpreadJSは英語を表示します(空の文字列 "" に設定されている場合、何も表示されません)。 引数は、表示に{0}、{1}、…を使用します(例:「無効な{0}:{1}({2}と{3}の間でなければなりません)。」、「高さ:{0}ピクセル」)。 カスタムローカライゼーションはfromJson / toJsonをサポートしていないため、ユーザーは必要になるたびに追加する必要があります。 サンプルのネームスペース(「common」、「Sheets」、「Filter」)はオプションです。 ただし、「Functions」と「TableFunctions」は必須です。 以下も有効な形式です。
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="ja-jp" /> <meta name="viewport" content="width=device-width, initial-scale=1.0" /> <link rel="stylesheet" type="text/css" href="$DEMOROOT$/ja/purejs/node_modules/@mescius/spread-sheets/styles/gc.spread.sheets.excel2013white.css"> <script src="$DEMOROOT$/ja/purejs/node_modules/@mescius/spread-sheets/dist/gc.spread.sheets.all.min.js" type="text/javascript"></script> <script src="$DEMOROOT$/ja/purejs/node_modules/@mescius/spread-sheets-resources-zh/dist/gc.spread.sheets.resources.zh.min.js" type="text/javascript"></script> <script src="$DEMOROOT$/ja/purejs/node_modules/@mescius/spread-sheets-resources-ja/dist/gc.spread.sheets.resources.ja.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%" 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; }