Namespace: I18N

STX. I18N

Namespace for Internationalization API

Members


<static> language :string

Must be set to the desired lanuage. Defaults to english "en"

Type:
  • string

<static> longMonths :Object

Sets the languages that that don't support shortening Translation will print entire month from locale for these languages

Type:
  • Object

Methods


<static> convertCSV( [csv])

Converts a CSV array of translations into the required JSON format. You can output this to the console and paste back in if desired. Assumes that the header row of the CSV is the language codes and that the first column is the key language (English). Assumes non-quoted words.

Parameters:
Name Type Argument Description
csv array <optional>

Optional Translation spreadsheet in csv format. Make sure no leading tabs, trailing commas or spaces. Default is STX.I18N.csv


<static> findAllTextNodes( [root])

Returns a word list containing unique words. Each word references an array of DOM nodes that contain that word. This can then be used for translation. Text nodes and placeholders which are found in the document tree will be wrapped by this function within a tag for easy translation back and forth.

Parameters:
Name Type Argument Description
root HTMLElement <optional>

Optional root for the TreeWalker. If omitted, document.body assumed.

Returns:

A word list containing unique words.

Type
object

<static> missingWordList( [language])

STX.I18N.missingWordList will scan the UI by walking all the text elements. It will determine which text elements have not been translated for the given language and return those as a JSON object.

Parameters:
Name Type Argument Description
language string <optional>

The language to search for missing words. Defaults to whatever language STX.I18N.language has set.


<static> printableMissingWordList( [language])

A convenient function for creating a human readable JSON object suitable for delivery to a translator.

Parameters:
Name Type Argument Description
language string <optional>

Optional language. Defaults to STX.I18N.language.


<static> setLanguage(stx, language [, translationCallback] [, csv])

Convenience function to set up translation services for a chart and its surrounding GUI. It automatically sets STX.I18N.language, loads all translations and translates the chart.

Parameters:
Name Type Argument Description
stx object

A chart object

language string

For instance 'en'

translationCallback string <optional>

Function to perform Canvas Built-in word translations . Default is STX.I18N.translate

csv array <optional>

Translation spreadsheet in csv format. Make sure no leading tabs, trailing commas or spaces. Default is STX.I18N.csv

Since:
  • 04-2015

<static> setLocale(stx, locale [, cb])

This method will set the chart locale using Intl natively or for unsupported browsers dynamically loads the locale using JSONP. Once the locale is loaded then the chart widget itself is updated for that locale. Use this function when a user can select a locale dynamically so as to avoid having to include specific locale entries as script tags. The optional callback will be called when the locale has been set. The Intl library includes JSONP for each locale. A zip of these locales can be requested and should be placed in the locale-data directory of your server.

Parameters:
Name Type Argument Description
stx object

A chart object

locale string

A valid locale, for instance en-IN

cb function <optional>

Callback when locale has been loaded. This function will be passed an error message if it cannot be loaded.


<static> translate(word [, language])

Translates an individual word for a given language. Set stxx.translationCallback to this function in order to automatically translate all textual elements on the chart itself.

Parameters:
Name Type Argument Description
word string

The word to translate

language string <optional>

Optional language. Defaults to STX.I18N.language.


<static> translateUI( [language] [, root])

Passes through the UI (DOM elements) and translates all of the text for the given language.

Parameters:
Name Type Argument Description
language string <optional>

Optional language. Defaults to STX.I18N.language.

root HTMLElement <optional>

Optional root for the TreeWalker. If omitted, document.body assumed.