352 lines
8.7 KiB
JavaScript
352 lines
8.7 KiB
JavaScript
/**
|
|
* Copyright (c) 2014 Vincent Petry <pvince81@owncloud.com>
|
|
*
|
|
* This file is licensed under the Affero General Public License version 3
|
|
* or later.
|
|
*
|
|
* See the COPYING-README file.
|
|
*
|
|
*/
|
|
|
|
import _ from 'underscore'
|
|
import $ from 'jquery'
|
|
import DOMPurify from 'dompurify'
|
|
import Handlebars from 'handlebars'
|
|
import identity from 'lodash/fp/identity'
|
|
import escapeHTML from 'escape-html'
|
|
|
|
import OC from './index'
|
|
import {
|
|
getAppTranslations,
|
|
hasAppTranslations,
|
|
registerAppTranslations,
|
|
unregisterAppTranslations,
|
|
} from './l10n-registry'
|
|
|
|
/**
|
|
* L10N namespace with localization functions.
|
|
*
|
|
* @namespace OC.L10n
|
|
*/
|
|
const L10n = {
|
|
|
|
/**
|
|
* Load an app's translation bundle if not loaded already.
|
|
*
|
|
* @param {String} appName name of the app
|
|
* @param {Function} callback callback to be called when
|
|
* the translations are loaded
|
|
* @returns {Promise} promise
|
|
*/
|
|
load: function(appName, callback) {
|
|
// already available ?
|
|
if (hasAppTranslations(appName) || OC.getLocale() === 'en') {
|
|
const deferred = $.Deferred()
|
|
const promise = deferred.promise()
|
|
promise.then(callback)
|
|
deferred.resolve()
|
|
return promise
|
|
}
|
|
|
|
const self = this
|
|
const url = OC.filePath(appName, 'l10n', OC.getLocale() + '.json')
|
|
|
|
// load JSON translation bundle per AJAX
|
|
return $.get(url)
|
|
.then(
|
|
function(result) {
|
|
if (result.translations) {
|
|
self.register(appName, result.translations, result.pluralForm)
|
|
}
|
|
})
|
|
.then(callback)
|
|
},
|
|
|
|
/**
|
|
* Register an app's translation bundle.
|
|
*
|
|
* @param {String} appName name of the app
|
|
* @param {Object<String,String>} bundle bundle
|
|
*/
|
|
register: function(appName, bundle) {
|
|
registerAppTranslations(appName, bundle, this._getPlural)
|
|
},
|
|
|
|
/**
|
|
* @private do not use this
|
|
*/
|
|
_unregister: unregisterAppTranslations,
|
|
|
|
/**
|
|
* Translate a string
|
|
* @param {string} app the id of the app for which to translate the string
|
|
* @param {string} text the string to translate
|
|
* @param {Object} [vars] map of placeholder key to value
|
|
* @param {number} [count] number to replace %n with
|
|
* @param {array} [options] options array
|
|
* @param {bool} [options.escape=true] enable/disable auto escape of placeholders (by default enabled)
|
|
* @param {bool} [options.sanitize=true] enable/disable sanitization (by default enabled)
|
|
* @returns {string}
|
|
*/
|
|
translate: function(app, text, vars, count, options) {
|
|
const defaultOptions = {
|
|
escape: true,
|
|
sanitize: true,
|
|
}
|
|
const allOptions = options || {}
|
|
_.defaults(allOptions, defaultOptions)
|
|
|
|
const optSanitize = allOptions.sanitize ? DOMPurify.sanitize : identity
|
|
const optEscape = allOptions.escape ? escapeHTML : identity
|
|
|
|
// TODO: cache this function to avoid inline recreation
|
|
// of the same function over and over again in case
|
|
// translate() is used in a loop
|
|
const _build = function(text, vars, count) {
|
|
return text.replace(/%n/g, count).replace(/{([^{}]*)}/g,
|
|
function(a, b) {
|
|
const r = vars[b]
|
|
if (typeof r === 'string' || typeof r === 'number') {
|
|
return optSanitize(optEscape(r))
|
|
} else {
|
|
return optSanitize(a)
|
|
}
|
|
}
|
|
)
|
|
}
|
|
let translation = text
|
|
const bundle = getAppTranslations(app)
|
|
const value = bundle.translations[text]
|
|
if (typeof (value) !== 'undefined') {
|
|
translation = value
|
|
}
|
|
|
|
if (typeof vars === 'object' || count !== undefined) {
|
|
return optSanitize(_build(translation, vars, count))
|
|
} else {
|
|
return optSanitize(translation)
|
|
}
|
|
},
|
|
|
|
/**
|
|
* Translate a plural string
|
|
* @param {string} app the id of the app for which to translate the string
|
|
* @param {string} textSingular the string to translate for exactly one object
|
|
* @param {string} textPlural the string to translate for n objects
|
|
* @param {number} count number to determine whether to use singular or plural
|
|
* @param {Object} [vars] map of placeholder key to value
|
|
* @param {array} [options] options array
|
|
* @param {bool} [options.escape=true] enable/disable auto escape of placeholders (by default enabled)
|
|
* @returns {string} Translated string
|
|
*/
|
|
translatePlural: function(app, textSingular, textPlural, count, vars, options) {
|
|
const identifier = '_' + textSingular + '_::_' + textPlural + '_'
|
|
const bundle = getAppTranslations(app)
|
|
const value = bundle.translations[identifier]
|
|
if (typeof (value) !== 'undefined') {
|
|
const translation = value
|
|
if ($.isArray(translation)) {
|
|
const plural = bundle.pluralFunction(count)
|
|
return this.translate(app, translation[plural], vars, count, options)
|
|
}
|
|
}
|
|
|
|
if (count === 1) {
|
|
return this.translate(app, textSingular, vars, count, options)
|
|
} else {
|
|
return this.translate(app, textPlural, vars, count, options)
|
|
}
|
|
},
|
|
|
|
/**
|
|
* The plural function taken from symfony
|
|
*
|
|
* @param {number} number the number of elements
|
|
* @returns {number}
|
|
* @private
|
|
*/
|
|
_getPlural: function(number) {
|
|
let language = OC.getLanguage()
|
|
if (language === 'pt_BR') {
|
|
// temporary set a locale for brazilian
|
|
language = 'xbr'
|
|
}
|
|
|
|
if (typeof language === 'undefined' || language === '') {
|
|
return (number === 1) ? 0 : 1
|
|
}
|
|
|
|
if (language.length > 3) {
|
|
language = language.substring(0, language.lastIndexOf('_'))
|
|
}
|
|
|
|
/*
|
|
* The plural rules are derived from code of the Zend Framework (2010-09-25),
|
|
* which is subject to the new BSD license (http://framework.zend.com/license/new-bsd).
|
|
* Copyright (c) 2005-2010 Zend Technologies USA Inc. (http://www.zend.com)
|
|
*/
|
|
switch (language) {
|
|
case 'az':
|
|
case 'bo':
|
|
case 'dz':
|
|
case 'id':
|
|
case 'ja':
|
|
case 'jv':
|
|
case 'ka':
|
|
case 'km':
|
|
case 'kn':
|
|
case 'ko':
|
|
case 'ms':
|
|
case 'th':
|
|
case 'tr':
|
|
case 'vi':
|
|
case 'zh':
|
|
return 0
|
|
|
|
case 'af':
|
|
case 'bn':
|
|
case 'bg':
|
|
case 'ca':
|
|
case 'da':
|
|
case 'de':
|
|
case 'el':
|
|
case 'en':
|
|
case 'eo':
|
|
case 'es':
|
|
case 'et':
|
|
case 'eu':
|
|
case 'fa':
|
|
case 'fi':
|
|
case 'fo':
|
|
case 'fur':
|
|
case 'fy':
|
|
case 'gl':
|
|
case 'gu':
|
|
case 'ha':
|
|
case 'he':
|
|
case 'hu':
|
|
case 'is':
|
|
case 'it':
|
|
case 'ku':
|
|
case 'lb':
|
|
case 'ml':
|
|
case 'mn':
|
|
case 'mr':
|
|
case 'nah':
|
|
case 'nb':
|
|
case 'ne':
|
|
case 'nl':
|
|
case 'nn':
|
|
case 'no':
|
|
case 'oc':
|
|
case 'om':
|
|
case 'or':
|
|
case 'pa':
|
|
case 'pap':
|
|
case 'ps':
|
|
case 'pt':
|
|
case 'so':
|
|
case 'sq':
|
|
case 'sv':
|
|
case 'sw':
|
|
case 'ta':
|
|
case 'te':
|
|
case 'tk':
|
|
case 'ur':
|
|
case 'zu':
|
|
return (number === 1) ? 0 : 1
|
|
|
|
case 'am':
|
|
case 'bh':
|
|
case 'fil':
|
|
case 'fr':
|
|
case 'gun':
|
|
case 'hi':
|
|
case 'hy':
|
|
case 'ln':
|
|
case 'mg':
|
|
case 'nso':
|
|
case 'xbr':
|
|
case 'ti':
|
|
case 'wa':
|
|
return ((number === 0) || (number === 1)) ? 0 : 1
|
|
|
|
case 'be':
|
|
case 'bs':
|
|
case 'hr':
|
|
case 'ru':
|
|
case 'sh':
|
|
case 'sr':
|
|
case 'uk':
|
|
return ((number % 10 === 1) && (number % 100 !== 11)) ? 0 : (((number % 10 >= 2) && (number % 10 <= 4) && ((number % 100 < 10) || (number % 100 >= 20))) ? 1 : 2)
|
|
|
|
case 'cs':
|
|
case 'sk':
|
|
return (number === 1) ? 0 : (((number >= 2) && (number <= 4)) ? 1 : 2)
|
|
|
|
case 'ga':
|
|
return (number === 1) ? 0 : ((number === 2) ? 1 : 2)
|
|
|
|
case 'lt':
|
|
return ((number % 10 === 1) && (number % 100 !== 11)) ? 0 : (((number % 10 >= 2) && ((number % 100 < 10) || (number % 100 >= 20))) ? 1 : 2)
|
|
|
|
case 'sl':
|
|
return (number % 100 === 1) ? 0 : ((number % 100 === 2) ? 1 : (((number % 100 === 3) || (number % 100 === 4)) ? 2 : 3))
|
|
|
|
case 'mk':
|
|
return (number % 10 === 1) ? 0 : 1
|
|
|
|
case 'mt':
|
|
return (number === 1) ? 0 : (((number === 0) || ((number % 100 > 1) && (number % 100 < 11))) ? 1 : (((number % 100 > 10) && (number % 100 < 20)) ? 2 : 3))
|
|
|
|
case 'lv':
|
|
return (number === 0) ? 0 : (((number % 10 === 1) && (number % 100 !== 11)) ? 1 : 2)
|
|
|
|
case 'pl':
|
|
return (number === 1) ? 0 : (((number % 10 >= 2) && (number % 10 <= 4) && ((number % 100 < 12) || (number % 100 > 14))) ? 1 : 2)
|
|
|
|
case 'cy':
|
|
return (number === 1) ? 0 : ((number === 2) ? 1 : (((number === 8) || (number === 11)) ? 2 : 3))
|
|
|
|
case 'ro':
|
|
return (number === 1) ? 0 : (((number === 0) || ((number % 100 > 0) && (number % 100 < 20))) ? 1 : 2)
|
|
|
|
case 'ar':
|
|
return (number === 0) ? 0 : ((number === 1) ? 1 : ((number === 2) ? 2 : (((number % 100 >= 3) && (number % 100 <= 10)) ? 3 : (((number % 100 >= 11) && (number % 100 <= 99)) ? 4 : 5))))
|
|
|
|
default:
|
|
return 0
|
|
}
|
|
},
|
|
}
|
|
|
|
export default L10n
|
|
|
|
/**
|
|
* Returns the user's locale as a BCP 47 compliant language tag
|
|
*
|
|
* @returns {String} locale string
|
|
*/
|
|
export const getCanonicalLocale = () => {
|
|
const locale = getLocale()
|
|
return typeof locale === 'string' ? locale.replace(/_/g, '-') : locale
|
|
}
|
|
|
|
/**
|
|
* Returns the user's locale
|
|
*
|
|
* @returns {String} locale string
|
|
*/
|
|
export const getLocale = () => $('html').data('locale')
|
|
|
|
/**
|
|
* Returns the user's language
|
|
*
|
|
* @returns {String} language string
|
|
*/
|
|
export const getLanguage = () => $('html').prop('lang')
|
|
|
|
Handlebars.registerHelper('t', function(app, text) {
|
|
return L10n.translate(app, text)
|
|
})
|