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
   • Use a predefined localization
   • Create a custom localization JSON file
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
• Create a custom localization JSON file

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:

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:

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:

new Flexmonster({
  container: "pivotContainer", 
  componentFolder: "node_modules/flexmonster/",   
  global: {
    localization: "loc/fr.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:

new Flexmonster({
  container: "pivotContainer",
  componentFolder: "node_modules/flexmonster/",
  report: {
    localization: "loc/fr.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:

• How to customize the Toolbar
• How to apply a CSS theme
• How to define a format for date and time
• How to set specific options common for all reports
• How to configure the data export