Spotfire在文本区域添加自定义JavaScript代码的最佳实践

这边文章包含了如何在TIBCO Spotfire分析文件的文本区域中以一种可支持和可维护的方式来开发自定义JavaScript代码的最佳实践和建议，因此，这些分析文件将持续与TIBCO Spotfire（译者注：以下简称Spotfire）的未来版本一起工作。

JavaScript（译者注：以下简称JS）可以通过 “Edit HTML” 选项，然后再单击工具栏中的 “Insert JavaScript” 按钮插入文本区域。

在文本区域中使用JavaScripts的目的是装饰您自己的元素并使它们更具交互性，例如在元素上添加高亮效果或创建一个交互式布局。

首先要知道的是，你所添加到文本区域的JS将与Spotfire定义的JS在相同的环境中执行，以实现文本区域中的所有功能以及Spotfire的其他可视化功能。这意味着Spotfire定义许多JS库的和第三方的存在于同一范围内，包括JQuery（$）和JQueryUI。TIBCO不能在其范围内保证这些库的正确性、可用性或兼容性。您对任何这些库的使用完全由您自己决定，TIBCO不支持或担保您使用这些库。

一般原则下，JS应该只修改HTML代码中您已经创建了并且可以自己控制的元素。这意味着JS应该只更改部分位于文本区域的HTML中定义的HTML DOM。因此，如果在JS操作的文本区域中添加div元素，那么就安全了。还意味着您不能假定您的DOM之外的其他元素是如何定义的，以便与Spotfire的未来版本兼容。例如，Spotfire中的表可视化的布局和定义可能在未来的版本中发生变化。

您可以在文本区域中添加过滤器、已计算值、Spotfire属性控件等。这些控件应该被视为Spotfire对象，它们在呈现时被转换成HTML。不建议将这些控件依赖于你所呈现的HTML，因为它可能在TIBCO Spotfire的未来版本中发生更改。

JS在文本区域中的顺序很重要。这脚本的顺序控制着其加载和执行，因此如果脚本之间有依赖关系，您需要检查脚本的顺序是否正确。

向文本区域添加JS的推荐方法是使用 “Insert JavaScript” 对话框。

可以通过URL等方式在不同的位置引用JavaScript，但是您应该意识到这样做的风险。DXP文件的所有用户都需要访问该URL，如果您想脱机工作，没有该访问就不可能正确地使用分析文件。

因为所有JS都共享相同的全局上下文，所以它们也共享全局事件。因此，不建议使用诸如侦听文档之类的全局事件。准备事件，因为这些可能会在Spotfire的未来版本中更改。上面提到的一般规则在这里也适用——只使用您可以自己控制的事件，并且只监听从您创建的元素中引发的事件。例如，不鼓励监听Spotfire控件中的事件。

---

以上。感谢各位朋友的赏读，后期持续分享一些优秀的文章。