利用 Flash JavaScript API 可以编写在 Flash 创作环境中(即用户保持 Flash 程序打开期间)执行多个动作的脚本。此功能与 ActionScript 语言不同,利用 ActionScript 语言可以编写能够在 Flash Player 环境中(即播放 SWF 文件期间)执行动作的脚本。此功能与 JavaScript 命令也不同,JavaScript 命令可以在用 Web 浏览器显示的页面中使用。
利用 JavaScript API,您可以编写有助于简化创作过程的 Flash 应用程序脚本。例如,您可以编写脚本来自动执行重复性任务,或向“工具”面板添加自定义工具。
Flash JavaScript API 在设计上类似于 Adobe ? Dreamweaver? 和 Adobe? Fireworks? JavaScript API(它们基于 Netscape JavaScript API 而设计)。Flash JavaScript API 基于文档对象模型 (DOM),该模型允许使用 JavaScript 对象访问 Flash 文档。Flash JavaScript API 包含 Netscape JavaScript API 及 Flash DOM 的所有元素。本文档将对这些新增的对象及其方法和属性进行说明。您可以在 Flash 脚本中使用本地 JavaScript 语言的任何元素,但只有在 Flash 文档上下文中有意义的元素才有效。
此外,JavaScript API 还包含一些方法,使您可组合使用 JavaScript 和自定义 C 代码来实现可扩展性。有关详细信息,请参阅 C 级可扩展性。
Flash 中的 JavaScript 解释程序采用的是 Mozilla SpiderMonkey 引擎 1.6 版,该版本可从网络中找到:www.mozilla.org/js/spidermonkey/。SpiderMonkey 是 Mozilla.org 开发的 JavaScript 语言的两种引用实现之一。它与嵌入 Mozilla 浏览器中的引擎相同。
SpiderMonkey 按照 ECMAScript (ECMA-262) 版本 3 语言规范中的定义,实现了核心 JavaScript 语言,并完全符合该规范的要求。只有那些特定于浏览器的主机对象(未包含在 ECMA-262 规范中)不受支持。同样,许多 JavaScript 参考指南都区分核心 JavaScript 和客户端(与浏览器相关的)JavaScript。只有核心 JavaScript 才适用于 Flash JavaScript 解释程序。
保存 JSFL 文件
您可以通过将 JSFL 脚本存储在 Configuration 文件夹内的多个文件夹之一中,使它们可用于 Flash 创作环境。默认情况下,Configuration 文件夹位于以下位置:
Windows? 7?:
引导驱动器\Users\用户名\AppData\Local\Adobe\Flash CS6\语言\Configuration\
Windows? Vista?:
引导驱动器\Users\用户名\Local Settings\Application Data\Adobe\Flash CS6\语言\Configuration\
Windows XP:
引导驱动器\Documents and Settings\用户名\Local Settings\Application Data\Adobe\Flash CS6\语言\Configuration\
Mac OS? X:
Macintosh HD/Users/用户名/Library/Application Support/Adobe/Flash CS6/语言/Configuration/
若要确定 Configuration 文件夹的位置,请使用 fl.configDirectory 或 fl.configURI,如下面的示例所示:
// store directory to a variable var configDir = fl.configDirectory; // display directory in the Output panel fl.trace(fl.configDirectory);
Configuration 文件夹中的以下文件夹可能包含您可在创作环境中访问的脚本:Behaviors(用于支持行为的用户界面);Commands(用于在“命令”菜单上显示的脚本);JavaScript(脚本助手用来填充用户界面控件的脚本);Tools(用于“工具”面板中的可扩展工具)和 WindowSWF(用于 Windows 菜单中显示的面板)。本文档主要介绍用于命令和工具的脚本。
如果编辑 Commands 文件夹中的脚本,新脚本随即便可用于 Flash。如果编辑用于可扩展工具的脚本,请关闭并重新启动 Flash,或者使用 fl.reloadTools() 命令。不过,如果您曾使用脚本向“工具”面板中添加可扩展工具,然后编辑脚本,请删除该工具,然后重新向“工具”面板中添加该工具,或者关闭并重新启动 Flash,以使修改后的工具可用。
您可以将命令和工具文件存储在两个位置,以便在创作环境中访问这些文件。
如果 JSFL 文件附带了其他文件(如 XML 文件),请将这些文件与 JSFL 文件存储在同一目录中。