2 Copyright (c) 2003-2010, CKSource - Frederico Knabben. All rights reserved.
\r
3 For licensing, see LICENSE.html or http://ckeditor.com/license
\r
8 var loadedLangs = {};
\r
13 * The list of languages available in the editor core.
\r
16 * alert( CKEDITOR.lang.en ); // "true"
\r
81 * Loads a specific language file, or auto detect it. A callback is
\r
82 * then called when the file gets loaded.
\r
83 * @param {String} languageCode The code of the language file to be
\r
84 * loaded. If "autoDetect" is set to true, this language will be
\r
85 * used as the default one, if the detect language is not
\r
86 * available in the core.
\r
87 * @param {Boolean} autoDetect Indicates that the function must try to
\r
88 * detect the user language and load it instead.
\r
89 * @param {Function} callback The function to be called once the
\r
90 * language file is loaded. Two parameters are passed to this
\r
91 * function: the language code and the loaded language entries.
\r
94 load : function( languageCode, defaultLanguage, callback )
\r
96 // If no languageCode - fallback to browser or default.
\r
97 // If languageCode - fallback to no-localized version or default.
\r
98 if ( !languageCode || !CKEDITOR.lang.languages[ languageCode ] )
\r
99 languageCode = this.detect( defaultLanguage, languageCode );
\r
101 if ( !this[ languageCode ] )
\r
103 CKEDITOR.scriptLoader.load( CKEDITOR.getUrl(
\r
104 '_source/' + // @Packager.RemoveLine
\r
105 'lang/' + languageCode + '.js' ),
\r
108 callback( languageCode, this[ languageCode ] );
\r
113 callback( languageCode, this[ languageCode ] );
\r
117 * Returns the language that best fit the user language. For example,
\r
118 * suppose that the user language is "pt-br". If this language is
\r
119 * supported by the editor, it is returned. Otherwise, if only "pt" is
\r
120 * supported, it is returned instead. If none of the previous are
\r
121 * supported, a default language is then returned.
\r
122 * @param {String} defaultLanguage The default language to be returned
\r
123 * if the user language is not supported.
\r
124 * @returns {String} The detected language code.
\r
126 * alert( CKEDITOR.lang.detect( 'en' ) ); // e.g., in a German browser: "de"
\r
128 detect : function( defaultLanguage, probeLanguage )
\r
130 var languages = this.languages;
\r
131 probeLanguage = probeLanguage || navigator.userLanguage || navigator.language;
\r
133 var parts = probeLanguage
\r
135 .match( /([a-z]+)(?:-([a-z]+))?/ ),
\r
139 if ( languages[ lang + '-' + locale ] )
\r
140 lang = lang + '-' + locale;
\r
141 else if ( !languages[ lang ] )
\r
144 CKEDITOR.lang.detect = lang ?
\r
145 function() { return lang; } :
\r
146 function( defaultLanguage ) { return defaultLanguage; };
\r
148 return lang || defaultLanguage;
\r