2018-06-08 13:58:59 -04:00
|
|
|
/**
|
|
|
|
* @license
|
|
|
|
* Visual Blocks Editor
|
|
|
|
*
|
|
|
|
* Copyright 2018 Google Inc.
|
|
|
|
* https://developers.google.com/blockly/
|
|
|
|
*
|
|
|
|
* Licensed under the Apache License, Version 2.0 (the "License");
|
|
|
|
* you may not use this file except in compliance with the License.
|
|
|
|
* You may obtain a copy of the License at
|
|
|
|
*
|
|
|
|
* http://www.apache.org/licenses/LICENSE-2.0
|
|
|
|
*
|
|
|
|
* Unless required by applicable law or agreed to in writing, software
|
|
|
|
* distributed under the License is distributed on an "AS IS" BASIS,
|
|
|
|
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
|
|
|
* See the License for the specific language governing permissions and
|
|
|
|
* limitations under the License.
|
|
|
|
*/
|
|
|
|
|
|
|
|
/**
|
|
|
|
* @fileoverview Scratch Messages singleton, with function to override Blockly.Msg values.
|
|
|
|
* @author chrisg@media.mit.edu (Chris Garrity)
|
|
|
|
*/
|
|
|
|
'use strict';
|
|
|
|
|
|
|
|
/**
|
2018-06-15 16:53:59 -04:00
|
|
|
* Name space for the ScratchMsgs singleton.
|
2018-06-08 13:58:59 -04:00
|
|
|
* Msg gets populated in the message files.
|
|
|
|
*/
|
|
|
|
goog.provide('Blockly.ScratchMsgs');
|
2018-06-12 12:36:04 -04:00
|
|
|
|
2018-06-08 13:58:59 -04:00
|
|
|
goog.require('Blockly.Msg');
|
|
|
|
|
2018-06-15 16:53:59 -04:00
|
|
|
|
|
|
|
/**
|
|
|
|
* The object containing messages for all locales - loaded from msg/scratch_msgs.
|
|
|
|
* @type {Object}
|
|
|
|
*/
|
|
|
|
Blockly.ScratchMsgs.locales = {};
|
2018-06-24 16:20:35 -04:00
|
|
|
|
|
|
|
/**
|
|
|
|
* The current locale.
|
|
|
|
* @type {String}
|
|
|
|
* @private
|
|
|
|
*/
|
|
|
|
Blockly.ScratchMsgs.currentLocale_ = 'en';
|
|
|
|
|
2018-06-08 13:58:59 -04:00
|
|
|
/**
|
|
|
|
* Change the Blockly.Msg strings to a new Locale
|
|
|
|
* Does not exist in Blockly, but needed in scratch-blocks
|
|
|
|
* @param {string} locale E.g., 'de', or 'zh-tw'
|
2018-06-25 11:18:50 -04:00
|
|
|
* @package
|
2018-06-08 13:58:59 -04:00
|
|
|
*/
|
|
|
|
Blockly.ScratchMsgs.setLocale = function(locale) {
|
|
|
|
if (Object.keys(Blockly.ScratchMsgs.locales).includes(locale)) {
|
2018-06-24 16:20:35 -04:00
|
|
|
Blockly.ScratchMsgs.currentLocale_ = locale;
|
2018-07-12 10:45:12 -04:00
|
|
|
Blockly.Msg = Object.assign({}, Blockly.Msg, Blockly.ScratchMsgs.locales[locale]);
|
2018-06-12 12:36:04 -04:00
|
|
|
} else {
|
|
|
|
// keep current locale
|
|
|
|
console.warn('Ignoring unrecognized locale: ' + locale);
|
2018-06-08 13:58:59 -04:00
|
|
|
}
|
|
|
|
};
|
2018-06-24 16:20:35 -04:00
|
|
|
|
|
|
|
/**
|
|
|
|
* Gets a localized message, for use in the Scratch VM with json init.
|
|
|
|
* Does not interpolate placeholders. Provided to allow default values in
|
|
|
|
* dynamic menus, for example, 'next backdrop', or 'random position'
|
|
|
|
* @param {string} msgId id for the message, key in Msg table.
|
|
|
|
* @param {string} defaultMsg string to use if the id isn't found.
|
|
|
|
* @param {string} useLocale optional locale to use in place of currentLocale_.
|
|
|
|
* @return {string} message with placeholders filled.
|
2018-06-25 11:18:50 -04:00
|
|
|
* @package
|
2018-06-24 16:20:35 -04:00
|
|
|
*/
|
|
|
|
Blockly.ScratchMsgs.translate = function(msgId, defaultMsg, useLocale) {
|
|
|
|
var locale = useLocale || Blockly.ScratchMsgs.currentLocale_;
|
|
|
|
|
|
|
|
if (Object.keys(Blockly.ScratchMsgs.locales).includes(locale)) {
|
|
|
|
var messages = Blockly.ScratchMsgs.locales[locale];
|
|
|
|
if (Object.keys(messages).includes(msgId)) {
|
|
|
|
return messages[msgId];
|
|
|
|
}
|
|
|
|
}
|
|
|
|
return defaultMsg;
|
|
|
|
};
|