JavaScript-Beispielskripte
In diesem Thema werden einige Beispiele für auf JavaScript basierende Skripte gezeigt, die im Textbereich verwendet werden können, um eine einfache Interaktivität bereitzustellen.
Tipp: In der Community gibt der Artikel Best Practices for Writing Custom JavaScript Code in Text Areas (Best Practices zum Schreiben von benutzerdefiniertem JavaScript-Code in Textbereichen) eine einführende Übersicht zur Verwendung von JavaScript in Textbereichen in Spotfire.
Anmerkung: Das JavaScript, das Sie einem Textbereich hinzufügen, wird in der gleichen Umgebung ausgeführt wie das von Spotfire zur Implementierung der Funktionalität im Textbereich und andere Spotfire-Visualisierungen definierte JavaScript. Das heißt, dass es eine Vielzahl von JavaScript-Bibliotheken von Spotfire und einschlägigen Drittanbietern gibt, darunter jQuery ($) und jQueryUI. Spotfire kann die Richtigkeit, Brauchbarkeit oder Kompatibilität der einschlägigen Bibliotheken in keiner Weise garantieren. Künftige Versionen von Spotfire werden wahrscheinlich andere, aktualisiert und/oder inkompatible Bibliotheken enthalten. Bibliotheken können auch in zukünftigen Versionen entfernt werden. Wenn Sie Bibliotheken wie jQuery oder jQueryUI verwenden möchten, müssen Sie diese Bibliotheken selbst importieren, anstatt sich auf die von Spotfire verwendeten Versionen zu verlassen. Weitere Informationen finden Sie im Community-Artikel Einbindung Ihrer eigenen Instanzen von jQuery und jQueryUI in Textbereiche.
Hintergrundfarbe eines Elements ändern, wenn sich der Mauszeiger darüber befindet
Im folgenden Skript werden die beiden Parameter „id“ und „color“ verwendet, wobei „id“ für die ID des Elements steht, dessen Hintergrundfarbe geändert werden soll (in diesem Beispiel „my-p“), und „color“ für die festzulegende Hintergrundfarbe (beispielsweise #e7e3e7). Beide Parameter werden als String-Parameter angegeben, wie im Bild des Dialogfelds JavaScript einfügen gezeigt.
------------------------------------------------------------------------ var elem = document.getElementById(id); if (!elem) { return; } var oldBgColor = elem.style.backgroundColor; var onEnter = function() { elem.style.backgroundColor = color; }; var onLeave = function() { elem.style.backgroundColor = oldBgColor; }; elem.onmouseover = onEnter; elem.onmouseout = onLeave; -------------------------------------------------------------------------Dieses Skript wird über den Aufruf der ID im HTML des Textbereichs ausgeführt.
Beispielsweise durch Hinzufügen der erforderlichen ID zu einem Absatz:
<p id="my-p">A JavaScript changes the background color when the mouse is over this paragraph.</p>Dies ergibt einen Textbereich, dessen Hintergrundfarbe sich in die angegebene Farbe ändert, wenn Sie den Mauszeiger über den Text im Absatz bewegen.
Anzeigen, wann der Textbereich als PDF oder Bild dargestellt werden kann
Wenn Ihr Skript asynchrone Aufrufe enthält, müssen Sie die SF.setBusy()-API verwenden, um sicherzustellen, dass der Textbereich beim Export in eine PDF- oder Bilddatei korrekt dargestellt wird.
Bei der Ausführung von
-------------------------------------------------------------------------
SF.setBusy(true);
-------------------------------------------------------------------------stellt der Export-Browser erst dann eine PDF bzw. ein Bild dar, wenn das Skript folgenden Befehl ausführt:
------------------------------------------------------------------------- SF.setBusy(false); -------------------------------------------------------------------------