123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349 |
- /**
- * 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 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') {
- var deferred = $.Deferred()
- var promise = deferred.promise()
- promise.then(callback)
- deferred.resolve()
- return promise
- }
-
- var self = this
- var 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)
- * @returns {string}
- */
- translate: function(app, text, vars, count, options) {
- var defaultOptions = {
- escape: true
- }
- var allOptions = options || {}
- _.defaults(allOptions, defaultOptions)
-
- // TODO: cache this function to avoid inline recreation
- // of the same function over and over again in case
- // translate() is used in a loop
- var _build = function(text, vars, count) {
- return text.replace(/%n/g, count).replace(/{([^{}]*)}/g,
- function(a, b) {
- var r = vars[b]
- if (typeof r === 'string' || typeof r === 'number') {
- if (allOptions.escape) {
- return DOMPurify.sanitize(escapeHTML(r))
- } else {
- return DOMPurify.sanitize(r)
- }
- } else {
- return DOMPurify.sanitize(a)
- }
- }
- )
- }
- var translation = text
- var bundle = getAppTranslations(app)
- var value = bundle.translations[text]
- if (typeof (value) !== 'undefined') {
- translation = value
- }
-
- if (typeof vars === 'object' || count !== undefined) {
- return DOMPurify.sanitize(_build(translation, vars, count))
- } else {
- return DOMPurify.sanitize(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') {
- var translation = value
- if ($.isArray(translation)) {
- var 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) {
- var 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)
- })
|