Viewer customization

Language

By default, the viewer looks at the browser’s language settings to decide what
language to display the viewer in.

You may optionally override the language of the viewer in one of two ways:

  1. Setting the lang parameter when requesting a view of your score, using
    the getScoreView API method.
  2. Adding the lang parameter yourself as a query parameter on the viewer
    URL

Language is specified using the same format as that used by the HTML
lang
attribute.

Language fall-backs

Currently we support these localizations:

  • American English (en-US)
  • British English (en-GB)
  • French (fr-FR)
  • German (de-DE)

If you specify a lang parameter for a language that is not supported
the viewer will attempt to fall back, first to the specified language, and
finally to English (en) if the specified language was not found.

For example, if you specified pt-BR (Brazilian Portuguese), the viewer would
fall back as follows:

  1. Search for a Brazilian Portuguese translation (pt-BR), not found
  2. Attempt to fall back to a Portuguese translation (pt), again not found
  3. Fall back to English (en)