Differences

This shows you the differences between two versions of the page.

--- de:cobi.wms:etikettenvorlagen [2025/10/24 11:06] – [JavaScript-Integration] thuth
+++ de:cobi.wms:etikettenvorlagen [2025/10/24 11:08] (current) – [JavaScript-Integration] thuth
@@ Line 227: / Line 227: @@
 Das HTML-Dokument, das nach der Verarbeitung einer COBI.wms-Etikettenvorlage entsteht, wird durch eine vollwertige Browser-Engine dargestellt. Das bedeutet, dass in der Vorlage nicht nur CSS, sondern auch JavaScript verwendet werden kann. Dies muss jedoch explizit aktiviert werden, indem der folgende Pseudo-Platzhalter irgendwo innerhalb der Datei eingefügt wird, z. B. innerhalb eines HTML-Kommentars am Anfang der Datei:
-Aktivierung:
 <code>
@@ Line 234: / Line 232: @@
 </code>
-Druckersteuerung erfolgt dann über JS:
+**HINWEIS:** Wenn JavaScript aktiviert ist, wird der Druck des gerenderten HTML-Dokuments nicht mehr automatisch ausgelöst. Stattdessen muss der Druck manuell aus dem JavaScript-Code gestartet werden, indem an geeigneter Stelle ''cobiwms.print()'' aufgerufen wird.
-''cobiwms.print()''
+Während der Ausführung des JavaScript-Codes steht das spezielle Objekt ''cobiwms'' zur Verfügung, das eine Reihe von Funktionen bereitstellt. Diese werden im Folgenden erläutert.
+<code>
+cobiwms.get(name)
+</code>
+Der Parameter ''name'' muss ein String sein. Er wird als Platzhalter interpretiert und sein Wert wird als String zurückgegeben.
+Beispiel: Ein Aufruf von ''cobiwms.get("itemName")'' liefert den Artikelnamen als Text zurück.
+(Man könnte zwar auch Platzhalter wie ''@itemName@'' direkt im Code verwenden, aber dann würde der Wert unverarbeitet in den Code eingefügt werden. Das heißt: Man müsste ihn in Anführungszeichen setzen wie ''"@itemName@"'', und sobald im tatsächlichen Wert selbst Anführungszeichen vorkommen, würde der Code fehlschlagen. Deshalb ist die Verwendung von ''cobiwms.get()'' in JavaScript deutlich sicherer.)
+<code>
+cobiwms.prompt(title, callback)
+</code>
+Durch den Aufruf dieser Funktion zeigt die App ein Popup mit einem Eingabefeld für den Benutzer an.
+Der Parameter ''title'' muss ein String sein und bestimmt die Überschrift des Popups.
+Der Parameter ''callback'' muss ebenfalls ein String sein und eine Funktion repräsentieren.
+Diese Funktion wird nach Bestätigung der Eingabe aufgerufen und erhält dabei einen Parameter,
+der den vom Benutzer eingegebenen Wert als String enthält.
 Zugriff auf Platzhalterwerte: