@schukai/monster 3.9.1 → 3.10.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@schukai/monster",
-  "version": "3.9.1",
+  "version": "3.10.1",
   "description": "Monster is a simple library for creating fast, robust and lightweight websites.",
   "keywords": [
     "framework",

package/source/dom/customelement.mjs

@@ -11,7 +11,7 @@ import { Pathfinder } from "../data/pathfinder.mjs";
 
 import { parseDataURL } from "../types/dataurl.mjs";
 import { getGlobalObject } from "../types/global.mjs";
-import { isArray, isFunction, isObject, isString } from "../types/is.mjs";
+import {isArray, isFunction, isIterable, isObject, isString} from "../types/is.mjs";
 import { Observer } from "../types/observer.mjs";
 import { ProxyObserver } from "../types/proxyobserver.mjs";
 import { validateFunction, validateInstance, validateObject, validateString } from "../types/validate.mjs";
@@ -27,6 +27,7 @@ import {
 import { findDocumentTemplate, Template } from "./template.mjs";
 import { addObjectWithUpdaterToElement } from "./updater.mjs";
 import { instanceSymbol } from "../constants.mjs";
+import {getDocumentTranslations, Translations} from "../i18n/translations.mjs";
 
 export {
     CustomElement,
@@ -281,6 +282,39 @@ class CustomElement extends HTMLElement {
         };
     }
 
+
+    /**
+     * This method updates the labels of the element.
+     * The labels are defined in the options object.
+     * The key of the label is used to retrieve the translation from the document.
+     * If the translation is different from the label, the label is updated.
+     * 
+     * Before you can use this method, you must have loaded the translations.
+     *
+     * @returns {Monster.DOM.CustomElement}
+     */
+    updateI18n() {
+
+        const translations = getDocumentTranslations();
+        if (!translations) {
+            return this;
+        }
+
+        const labels = this.getOption("labels");
+        if(!isIterable(labels)){
+            return this;
+        }
+        
+        for (const key in labels) {
+            const text = translations.getText(key, labels[key]);
+            if (text !== labels[key]) {
+                this.setOption("labels." + key, text);
+            }
+
+        }
+        return this;
+    }    
+    
     /**
      * There is no check on the name by this class. the developer is responsible for assigning an appropriate tag.
      * if the name is not valid, registerCustomElement() will issue an error
@@ -293,6 +327,7 @@ class CustomElement extends HTMLElement {
     static getTag() {
         throw new Error("the method getTag must be overwritten by the derived class.");
     }
+    
 
     /**
      * At this point a `CSSStyleSheet` object can be returned. If the environment does not

package/source/i18n/translations.mjs

@@ -190,10 +190,12 @@ class Translations extends Base {
 /**
  * Returns the translations for the current document.
  *
- * @param element
- * @returns {*}
- * @throws {Error} Element is not an HTMLElement
- * @throws {Error} Missing translations
+ * @param {HTMLElement|undefined} [element] - Element to search for translations. Default: element with objectlink @schukai/monster/i18n/translations@@link.
+ * @returns {Translations}
+ * @throws {Error} Element is not an HTMLElement.
+ * @throws {Error} Cannot find element with translations. Add a translations object to the document.
+ * @throws {Error} This element has no translations.
+ * @throws {Error} Missing translations.
  */
 function getDocumentTranslations(element) {
 
@@ -201,14 +203,17 @@ function getDocumentTranslations(element) {
 
     if (!(element instanceof HTMLElement)) {
         element = d.querySelector('['+ATTRIBUTE_OBJECTLINK+'~="' + translationsLinkSymbol.toString() + '"]');
+        if (element === null) {
+            throw new Error("Cannot find element with translations. Add a translations object to the document.");
+        }
     }
 
     if (!(element instanceof HTMLElement)) {
-        throw new Error("Element is not an HTMLElement");
+        throw new Error("Element is not an HTMLElement.");
     }
 
     if (!hasObjectLink(element, translationsLinkSymbol)) {
-        throw new Error("Missing translations");
+        throw new Error("This element has no translations.");
     }
     
     let obj = getLinkedObjects(element, translationsLinkSymbol);
@@ -219,7 +224,7 @@ function getDocumentTranslations(element) {
         }
     }
 
-    throw new Error("Missing translations");
+    throw new Error("Missing translations.");
 
 }
 

package/source/types/version.mjs

@@ -142,7 +142,7 @@ function getMonsterVersion() {
     }
 
     /** don't touch, replaced by make with package.json version */
-    monsterVersion = new Version("3.9.1");
+    monsterVersion = new Version("3.10.1");
 
     return monsterVersion;
 }

package/test/cases/monster.mjs

@@ -7,7 +7,7 @@ describe('Monster', function () {
         let monsterVersion
 
         /** don´t touch, replaced by make with package.json version */
-        monsterVersion = new Version("3.9.1")
+        monsterVersion = new Version("3.10.1")
 
         let m = getMonsterVersion();