JasonWoof Got questions, comments, patches, etc.? Contact Jason Woofenden
add998259ed66ccc6a65f7af0f338db76514f9cc
[ckeditor.git] / _source / core / lang.js
1 /*\r
2 Copyright (c) 2003-2010, CKSource - Frederico Knabben. All rights reserved.\r
3 For licensing, see LICENSE.html or http://ckeditor.com/license\r
4 */\r
5 \r
6 (function()\r
7 {\r
8         var loadedLangs = {};\r
9 \r
10         CKEDITOR.lang =\r
11         {\r
12                 /**\r
13                  * The list of languages available in the editor core.\r
14                  * @type Object\r
15                  * @example\r
16                  * alert( CKEDITOR.lang.en );  // "true"\r
17                  */\r
18                 languages :\r
19                 {\r
20                         'af'    : 1,\r
21                         'ar'    : 1,\r
22                         'bg'    : 1,\r
23                         'bn'    : 1,\r
24                         'bs'    : 1,\r
25                         'ca'    : 1,\r
26                         'cs'    : 1,\r
27                         'cy'    : 1,\r
28                         'da'    : 1,\r
29                         'de'    : 1,\r
30                         'el'    : 1,\r
31                         'en-au' : 1,\r
32                         'en-ca' : 1,\r
33                         'en-gb' : 1,\r
34                         'en'    : 1,\r
35                         'eo'    : 1,\r
36                         'es'    : 1,\r
37                         'et'    : 1,\r
38                         'eu'    : 1,\r
39                         'fa'    : 1,\r
40                         'fi'    : 1,\r
41                         'fo'    : 1,\r
42                         'fr-ca' : 1,\r
43                         'fr'    : 1,\r
44                         'gl'    : 1,\r
45                         'gu'    : 1,\r
46                         'he'    : 1,\r
47                         'hi'    : 1,\r
48                         'hr'    : 1,\r
49                         'hu'    : 1,\r
50                         'is'    : 1,\r
51                         'it'    : 1,\r
52                         'ja'    : 1,\r
53                         'km'    : 1,\r
54                         'ko'    : 1,\r
55                         'lt'    : 1,\r
56                         'lv'    : 1,\r
57                         'mn'    : 1,\r
58                         'ms'    : 1,\r
59                         'nb'    : 1,\r
60                         'nl'    : 1,\r
61                         'no'    : 1,\r
62                         'pl'    : 1,\r
63                         'pt-br' : 1,\r
64                         'pt'    : 1,\r
65                         'ro'    : 1,\r
66                         'ru'    : 1,\r
67                         'sk'    : 1,\r
68                         'sl'    : 1,\r
69                         'sr-latn'       : 1,\r
70                         'sr'    : 1,\r
71                         'sv'    : 1,\r
72                         'th'    : 1,\r
73                         'tr'    : 1,\r
74                         'uk'    : 1,\r
75                         'vi'    : 1,\r
76                         'zh-cn' : 1,\r
77                         'zh'    : 1\r
78                 },\r
79 \r
80                 /**\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
92                  * @example\r
93                  */\r
94                 load : function( languageCode, defaultLanguage, callback )\r
95                 {\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
100 \r
101                         if ( !this[ languageCode ] )\r
102                         {\r
103                                 CKEDITOR.scriptLoader.load( CKEDITOR.getUrl(\r
104                                         '_source/' +    // @Packager.RemoveLine\r
105                                         'lang/' + languageCode + '.js' ),\r
106                                         function()\r
107                                                 {\r
108                                                         callback( languageCode, this[ languageCode ] );\r
109                                                 }\r
110                                                 , this );\r
111                         }\r
112                         else\r
113                                 callback( languageCode, this[ languageCode ] );\r
114                 },\r
115 \r
116                 /**\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
125                  * @example\r
126                  * alert( CKEDITOR.lang.detect( 'en' ) );  // e.g., in a German browser: "de"\r
127                  */\r
128                 detect : function( defaultLanguage, probeLanguage )\r
129                 {\r
130                         var languages = this.languages;\r
131                         probeLanguage = probeLanguage || navigator.userLanguage || navigator.language;\r
132 \r
133                         var parts = probeLanguage\r
134                                         .toLowerCase()\r
135                                         .match( /([a-z]+)(?:-([a-z]+))?/ ),\r
136                                 lang = parts[1],\r
137                                 locale = parts[2];\r
138 \r
139                         if ( languages[ lang + '-' + locale ] )\r
140                                 lang = lang + '-' + locale;\r
141                         else if ( !languages[ lang ] )\r
142                                 lang = null;\r
143 \r
144                         CKEDITOR.lang.detect = lang ?\r
145                                 function() { return lang; } :\r
146                                 function( defaultLanguage ) { return defaultLanguage; };\r
147 \r
148                         return lang || defaultLanguage;\r
149                 }\r
150         };\r
151 \r
152 })();\r