Need a special offer?Find out if your project fits.
+
  1. API reference
  • Introduction
  • Connecting to Data Source
  • Browser compatibility
  • Documentation for older versions
  • Table of contents

    Localizing the component

    On our website, you can see an example of a localized version of Flexmonster Pivot in this demo: Localization. The component can be localized to Spanish, French, Italian, Portuguese, Mandarin, etc. The following article describes how the component can be localized.

    The default language for all text elements in the pivot table is English. The full process of component localization involves two steps:

    1. Choose localization
    2. Set the localization for the pivot table

    Step 1. Choose localization

    The localization can be defined in a JSON file that has a list of all texts and labels that are used in Flexmonster Pivot and can be localized.

    You can choose a ready-to-use localization or create a custom one:

    Use a predefined localization

    If you plan to use one of our ready-to-use localizations, download the respective localization file from our GitHub or use a localization file from our CDN:

    Download a localization file

    Just click the file with language below or right click and save locally:

    Use a localization file from our CDN

    Find a link to the file with your localization:

    • English: https://cdn.flexmonster.com/loc/en.json
    • German: https://cdn.flexmonster.com/loc/de.json
    • Español: https://cdn.flexmonster.com/loc/es.json
    • Français: https://cdn.flexmonster.com/loc/fr.json
    • Italiano: https://cdn.flexmonster.com/loc/it.json
    • Português: https://cdn.flexmonster.com/loc/pt.json
    • Chinese: https://cdn.flexmonster.com/loc/zh.json
    • Ukrainian: https://cdn.flexmonster.com/loc/uk.json
    • Magyar: https://cdn.flexmonster.com/loc/hu.json
    • Dutch: https://cdn.flexmonster.com/loc/nl.json
    • Turkish: https://cdn.flexmonster.com/loc/tr.json
    • Thai: https://cdn.flexmonster.com/loc/th.json
    • Indonesian: https://cdn.flexmonster.com/loc/id.json

    If you have decided to use one of the above files, you can jump to Step 2. Set localization for Flexmonster Pivot.

    Create a custom localization JSON file

    If you want to use a different language, it is possible to create your own localization file. We recommend using the English localization file as a template. Download it, make a copy, and replace all English texts with your own. After creating a new localization file, our team suggests sharing it with the community to help other users. New localization files can be added by creating a new pull request on GitHub. The Flexmonster team will highly appreciate any new localization files and add them to our website.

    In the following example, we localize the calculated value window in the pivot table to French.

    The original section of the localization file looks as follows.

    "calculatedView": {
    "measureBox": "Drag Values To Formula",
    "measureName": "Value name",
    "calculateIndividualValues": "Calculate individual values"
    }

    Now we replace the respective terms with French.

    "calculatedView": {
    "measureBox": "Deplacez valeur a la formule",
    "measureName": "Nom de la valeur",
    "calculateIndividualValues": "Calculer les valeurs individuelles"
    }

    Once the localization JSON file is loaded (see the next step), your pivot table should show the following changes in the calculated value view:

    calculatingViewFrench

    Your localization can be partial. For example, if you don’t need to localize the pivot table completely, you can replace only those JSON objects that you want to translate. If certain label translations are not mentioned in the localization JSON file, they will be set to their default English values.

    Step 2. Set localization for Flexmonster Pivot

    Localization can be set as inline JSON or a URL to the localization JSON file. To preset localization for all reports, set the localization property in the GlobalObject. Here is an example:

    URL to JSON

    new Flexmonster({
      container: "pivotContainer", 
      componentFolder: "node_modules/flexmonster/",   
      global: {
        localization: "loc/fr.json"
      },
      ...
    }); 

    JSON

    new Flexmonster({
      container: "pivotContainer",
      componentFolder: "node_modules/flexmonster/",
      global: {
        localization: {
          "calculatedView": {
            "measureBox": "Deplacez valeur a la formule",
            "measureName": "Nom de la valeur",
            "formula": "Formule"
          }
        }
      },
      ...
    }); 

    To specify different localization for a particular report, set the localization property in the report object. Here is an example:

    URL to JSON

    new Flexmonster({
      container: "pivotContainer",
      componentFolder: "node_modules/flexmonster/",
      report: {
        localization: "loc/fr.json"
      },
      ...
    }); 

    JSON

    new Flexmonster({
      container: "pivotContainer",
      componentFolder: "node_modules/flexmonster/",
      report: { 
        localization: { 
          "calculatedView": {
            "measureBox": "Deplacez valeur a la formule",
            "measureName": "Nom de la valeur",
            "formula": "Formule"
          }
        }
      },
      ...
    }); 

    What’s next?

    You may be interested in the following articles: