39dc0c6097
The -*- file variable lines -*- establish per-file settings that Emacs will pick up. This patch makes the following changes to those lines (and touches nothing else): - Never set the buffer's mode. Years ago, Emacs did not have a good JavaScript mode, so it made sense to use Java or C++ mode in .js files. However, Emacs has had js-mode for years now; it's perfectly serviceable, and is available and enabled by default in all major Emacs packagings. Selecting a mode in the -*- file variable line -*- is almost always the wrong thing to do anyway. It overrides Emacs's default choice, which is (now) reasonable; and even worse, it overrides settings the user might have made in their '.emacs' file for that file extension. It's only useful when there's something specific about that particular file that makes a particular mode appropriate. - Correctly propagate settings that establish the correct indentation level for this file: c-basic-offset and js2-basic-offset should be js-indent-level. Whatever value they're given should be preserved; different parts of our tree use different indentation styles. - We don't use tabs in Mozilla JS code. Always set indent-tabs-mode: nil. Remove tab-width: settings, at least in files that don't contain tab characters. - Remove js2-mode settings that belong in the user's .emacs file, like js2-skip-preprocessor-directives.
120 lines
3.4 KiB
JavaScript
120 lines
3.4 KiB
JavaScript
/* -*- indent-tabs-mode: nil; js-indent-level: 2 -*- */
|
|
/* vim: set shiftwidth=2 tabstop=2 autoindent cindent expandtab: */
|
|
|
|
'use strict';
|
|
|
|
// This is a modified version of l10n.js that the pdf.js extension uses.
|
|
// It uses an explicitly passed object for the strings/locale functionality,
|
|
// and does not automatically translate on DOMContentLoaded, but requires
|
|
// initialize to be called. This improves testability and helps to avoid race
|
|
// conditions.
|
|
(function(window) {
|
|
var gL10nDetails;
|
|
var gLanguage = '';
|
|
|
|
// fetch an l10n objects
|
|
function getL10nData(key) {
|
|
var response = gL10nDetails.getStrings(key);
|
|
var data = JSON.parse(response);
|
|
if (!data)
|
|
console.warn('[l10n] #' + key + ' missing for [' + gLanguage + ']');
|
|
return data;
|
|
}
|
|
|
|
// replace {{arguments}} with their values
|
|
function substArguments(text, args) {
|
|
if (!args)
|
|
return text;
|
|
|
|
return text.replace(/\{\{\s*(\w+)\s*\}\}/g, function(all, name) {
|
|
return name in args ? args[name] : '{{' + name + '}}';
|
|
});
|
|
}
|
|
|
|
// translate a string
|
|
function translateString(key, args, fallback) {
|
|
var data = getL10nData(key);
|
|
if (!data && fallback)
|
|
data = {textContent: fallback};
|
|
if (!data)
|
|
return '{{' + key + '}}';
|
|
return substArguments(data.textContent, args);
|
|
}
|
|
|
|
// translate an HTML element
|
|
function translateElement(element) {
|
|
if (!element || !element.dataset)
|
|
return;
|
|
|
|
// get the related l10n object
|
|
var key = element.dataset.l10nId;
|
|
var data = getL10nData(key);
|
|
if (!data)
|
|
return;
|
|
|
|
// get arguments (if any)
|
|
// TODO: more flexible parser?
|
|
var args;
|
|
if (element.dataset.l10nArgs) try {
|
|
args = JSON.parse(element.dataset.l10nArgs);
|
|
} catch (e) {
|
|
console.warn('[l10n] could not parse arguments for #' + key + '');
|
|
}
|
|
|
|
// translate element
|
|
// TODO: security check?
|
|
for (var k in data)
|
|
element[k] = substArguments(data[k], args);
|
|
}
|
|
|
|
|
|
// translate an HTML subtree
|
|
function translateFragment(element) {
|
|
element = element || document.querySelector('html');
|
|
|
|
// check all translatable children (= w/ a `data-l10n-id' attribute)
|
|
var children = element.querySelectorAll('*[data-l10n-id]');
|
|
var elementCount = children.length;
|
|
for (var i = 0; i < elementCount; i++)
|
|
translateElement(children[i]);
|
|
|
|
// translate element itself if necessary
|
|
if (element.dataset.l10nId)
|
|
translateElement(element);
|
|
}
|
|
|
|
// Public API
|
|
document.mozL10n = {
|
|
/**
|
|
* Called to do the initial translation, this should be called
|
|
* when DOMContentLoaded is fired, or the equivalent time.
|
|
*
|
|
* @param {Object} l10nDetails An object implementing the locale attribute
|
|
* and getStrings(key) function.
|
|
*/
|
|
initialize: function(l10nDetails) {
|
|
gL10nDetails = l10nDetails;
|
|
gLanguage = gL10nDetails.locale;
|
|
|
|
translateFragment();
|
|
},
|
|
|
|
// get a localized string
|
|
get: translateString,
|
|
|
|
// get the document language
|
|
getLanguage: function() { return gLanguage; },
|
|
|
|
// get the direction (ltr|rtl) of the current language
|
|
getDirection: function() {
|
|
// http://www.w3.org/International/questions/qa-scripts
|
|
// Arabic, Hebrew, Farsi, Pashto, Urdu
|
|
var rtlList = ['ar', 'he', 'fa', 'ps', 'ur'];
|
|
return (rtlList.indexOf(gLanguage) >= 0) ? 'rtl' : 'ltr';
|
|
},
|
|
|
|
// translate an element or document fragment
|
|
translate: translateFragment
|
|
};
|
|
})(this);
|