Merge pull request stefalda#97 from fbacker/overwrite

feature: overwrite content

Author: stefalda

LocalizedStrings.js

@@ -43,6 +43,13 @@ class LocalizedStrings {
         this.setLanguage(interfaceLanguage);
     }
 
+    //Overwrite content, use for e.g. dynamicly reload locale from server
+    setContent(props){
+        this.props = props;
+        //Set language to its default value (the interface)
+        this.setLanguage(this.language);
+    }
+
     //Can be used from ouside the class to force a particular language
     //indipendently from the interface one
     setLanguage(language) {
@@ -93,6 +100,11 @@ class LocalizedStrings {
         return interfaceLanguage;
     }
 
+    //The current props (locale object)
+    getLocaleObject() {
+        return this.props;
+    }
+
     //Return an array containing the available languages passed as props in the constructor
     getAvailableLanguages() {
         if (!this.availableLanguages) {

README.md

@@ -126,6 +126,35 @@ Then use the `strings` object literal directly in the render method accessing th
 
 The first language is considered the default one, so if a translation is missing for the selected language, the default one is shown and a line is written to the log as a reminder.
 
+#### Update / Overwrite Locale
+
+You might have default localized in the build but then download the latest localization strings from a server. Use setContent to overwrite the whole object. **NOTE** that this will remove all other localizations if used.
+
+```js
+strings.setContent({
+  en:{
+    how:"How do you want your egg todajsie?",
+    boiledEgg:"Boiled eggsie",
+    softBoiledEgg:"Soft-boiled egg",
+    choice:"How to choose the egg"
+  }
+})
+```
+
+You can also only overwrite a specific language using
+
+```js
+strings.setContent(Object.assign({},strings.getLocaleObject(),
+{
+  en:{
+    how:"How do you want your egg todajsie?",
+    boiledEgg:"Boiled eggsie",
+    softBoiledEgg:"Soft-boiled egg",
+    choice:"How to choose the egg"
+  }
+}));
+```
+
 ## Typescript
 For TypeScript, your `tsconfig.json` should be something like this:
 ```json