编写和管理脚本

上次更新日期: 2023年5月24日

设置代码格式

可以自动设置代码的格式并缩进代码 键入时。 如果使用动态字体映射,则应确保 正确的字体用于多语言文本。

设置自动套用格式选项

请执行下列操作之一:
  • 在面板菜单 (位于动作面板的右上角)中选择“首选参数”。

  • 在“脚本”窗口中选择“编辑”>“首选参数”(Windows) 或“Animate”>“首选参数”(Macintosh)。

在“首选参数”对话框中,选择“自动套用格式”。
选择任意“自动套用格式”选项。

在设置自动格式选项后,将应用您的设置 自动写入到您编写的代码,而不是现有代码;您 必须手动将您的设置应用于现有代码。

按照自动套用格式设置设置代码格式

  • 单击中的“自动格式化” “动作”面板或“脚本”窗口工具栏。
  • 从面板菜单(位于 动作面板)中,选择自动设置格式。
  • 按下 Ctrl+Shift+F 组合键 (Windows) 或 Command+Shift+F 组合键 (Macintosh)。
  • 在脚本窗口中,选择“工具”>“自动” 格式。

使用动态字体映射

要打开或关闭动态字体映射, 在首选项对话框中选择或取消选择“使用动态字体映射” 盒子。

默认情况下,动态字体映射处于关闭状态,因为它 增加了编写脚本时的性能时间。 如果您正在工作 使用多语言文本,打开动态字体映射,因为它 有助于确保使用正确的字体。

使用自动缩进

要打开或关闭自动缩进,请选择 或取消选择“首选项”对话框中的“自动缩进”。

打开自动缩进后,键入的文本 在左圆括号“(”或左大括号“{”后面会自动出现 根据ActionScript首选项中的制表符大小设置缩进。

向内 在脚本中,您可以通过选择行并按 Tab。 要取消缩进,请选择该行,然后按下 Shift+Tab 组合键。

对代码中的某些部分进行注释

代码注释是代码中被 ActionScript 编译器忽略的部分。 注释行可解释代码的操作,也可以暂时停用您不想删除的代码。 通过在代码行的开头加上双斜杠 (//) 可对其进行注释。 编译器将忽略双斜杠后面一行的所有文本。 您还可以对较大的代码块进行注释,方法是:在代码块的开头加上一个斜杠和一个星号 (/*),并在代码块的结尾加上一个星号和一个斜杠 (*/)。

您可以手动键入这些注释标记,也可以使用动作面板或“脚本”窗口顶部的按钮来添加它们。

对代码行进行注释

将插入点放在开头 行或要开始注释的字符处。
右键单击并选择“注释”。 您也可以使用 键盘快捷键Ctrl + M (Windows)或Command + M ,或转到编辑 >注释选择。

一个双斜杠 (//) 将会被置于插入点处。

对多行代码进行注释

选择要注释的行。 (第一个 所选内容的最后几行可以是部分行。)
右键单击并选择“注释”。 您也可以使用 键盘快捷键Ctrl + M (Windows)或Command + M ,或转到编辑 >注释选择。

块注释字符位于开头 (/*)和所选内容的结尾(*/)。

注释

如果有注释 在所选文本行之间,将应用行注释 在所有选定行上。

删除注释

将插入点放置在行中 注释的代码块,或选择已注释的代码块。
右键单击并选择“取消注释”。 您也可以使用 键盘快捷键Ctrl + Shift + M (Windows)或Command + Shift + M或转到编辑>取消注释所选内容。

使用语法着色

与任何语言一样,在ActionScript中,语法是 元素集合起来创造意义的方式。 如果您使用 ActionScript语法不正确,脚本无法工作。

收件人 突出显示语法错误,为脚本的各个部分设置颜色代码。 例如,假设您将语法着色首选项设置为 关键字以蓝色显示。 当您键入var时, 单词var显示为蓝色。 但是,如果你误解了 键入vae,保留单词vae 黑色,表示您输入错误。

请执行下列操作之一:

  • 选择“编辑”>“首选参数”(Windows) 或“Animate”>“首选参数”(Macintosh),在“类别”列表中单击“代码编辑器”,然后指定“语法着色”设置。

  • 将插入点置于“脚本”窗格中,按下 Ctrl-U (Windows) 或 Command-U (Macintosh)。

注释

在动作面板中编写脚本时, 您使用的播放器版本不支持的命令 目标在“动作”工具箱中显示为黄色。 例如, 如果SWF文件版本设置为Flash7,请ActionScript 只有Flash Player8支持的内容在“操作”中显示为黄色 工具箱。

使用标识符和关键字 在运行时列出

Animate 在启动时,它会从资源文件中读取标识符和关键字列表,并将其放入缓存。 除了从资源读取默认列表外,它还会扫描 Preference 文件夹中的其他关键字和标识符列表。 可以通过在以下文件夹中添加“.txt”文件来添加额外的关键字和标识符:

  • C:\Users\<用户名>[AppData]\Roaming\Adobe\Animate\13.0[ActionscriptKeywords]\

  • C:\Users\<用户名>[AppData]\Roaming\Adobe\Animate\13.0[ActionscriptIdentifiers]\

  • C:\Users\<用户名>[AppData]\Roaming\Adobe\Animate\13.0[JavascriptKeywords]\

  • C:\Users\<用户名>[AppData]\Roaming\Adobe\Animate\13.0[JavascriptIdentifiers]\

使用行号和自动换行

编辑或修改代码时,行号 使代码更易于滚动和解析。 自动换行可帮助您避免 水平滚动代码行(特别是在工作时) (在创作环境中,或在屏幕分辨率较低时)。

启用或禁用行号

  • 向内 在“脚本”窗口中,选择“视图”>“行号”。
  • 按下 Ctrl+Shift+L 组合键 (Windows) 或 Command+Shift+L 组合键 (Macintosh)。

加亮显示特定行

  • 在“脚本”窗口中,选择 “编辑”>“转至行”。

启用或禁用自动换行

  • 在“脚本”窗口中, 选择“视图”>“自动换行”。
  • 按下 Ctrl+Shift+W (Windows) 或 Command+Shift+W (Macintosh)。

显示隐藏字符

空格、制表符、 和换行符在ActionScript代码中隐藏。 您可能需要 显示这些字符;例如,必须查找并删除 双字节空格,不是字符串值的一部分,因为 它们会导致编译器错误。

  • 按Control+Shift+8 (Windows)或Command+Shift+8 (Macintosh)。

以下内容 符号用于显示隐藏字符。

隐藏字符

符号

单字节空格

.

双字节空格

l

制表符

>>

换行符


在脚本中查找文本

“查找”工具可让您查找和替换文本 脚本中的字符串。

注释

若要在 Animate 文档的所有脚本中搜索文本,请使用“影片浏览器”。

查找文本

在动作面板或“脚本”窗口中, 单击“查找”或 按Control+F (Windows)或Command+F (Macintosh)。
输入搜索字符串。
单击“查找下一个”。

在脚本中查找并替换文本

在动作面板或“脚本”窗口中, 单击“查找”或 按Control+F (Windows)或Command+F (Macintosh)。
输入搜索字符串。
在“替换为”文本框中,输入新字符串。
单击“查找下一个”。
若要替换字符串,请单击“替换”;以替换全部 如果出现字符串,请单击“全部替换”。

(Animate中已弃用)在“动作”面板中重复搜索

从面板菜单 (位于 (在“动作”面板的右上角)选择“重新查找”。

(Animate中已弃用)在“脚本”窗口中重复搜索

选择“编辑”>“再次查找”。

(Animate 中已弃用)检查语法和标点

您可以快速检查 ActionScript代码,而不发布FLA文件。

何时 如果检查语法,则检查当前脚本。 如果当前 脚本调用ActionScript类,这些类也会被检查。 但不会检查可能位于 FLA 文件中的其他脚本。

为了 ActionScript 2.0文件,检查语法通过编译器运行代码,生成 语法和编译器错误。

对于ActionScript3.0文件,请检查 语法仅生成语法错误。 要生成编译器错误, 例如类型不匹配、返回值不正确以及变量或方法 命名拼写错误,必须使用“控制”>“测试”命令。

语法检查

要检查语法,请执行以下操作之一:

  • 在动作面板或“脚本”窗口中, 单击“检查语法”
  • 单击“脚本”窗格,然后按Control+T (Windows) 或Command+T (Macintosh)。 在“脚本”窗格中单击或键入 让它成为焦点。 如果舞台上的对象具有焦点, 而打开“变换”面板。

语法错误列在“编译器错误”面板中。

注释

向内 “脚本”窗口中的外部ActionScript类文件, 类路径(AS2)或源路径(AS3)影响语法检查。 平衡 如果正确设置了全局类路径或源路径,则可以 生成错误,因为编译器不知道此类 正在编译。

检查标点平衡

单击大括号{},括号 脚本中的[]或括号()。
在Windows中,按Control+'(单引号);在Macintosh中, 按Command+'(单引号)。 大括号,括号之间的文本, 或圆括号高亮显示,以便您检查左标点 有相应的结束标点。

(Animate中已弃用)导入和导出脚本

可以将脚本导入 动作面板或“脚本”窗口。 您还可以导出脚本 从动作面板复制到外部ActionScript文件。 (当您 使用“脚本”窗口,无需导出,因为可以 而应保存AS文件。)

如果 打开或导入脚本时,脚本中的文本无法按预期显示 在文件中,更改导入编码首选项。

导入外部 AS 文件

在“脚本”窗格中,放置插入文件 指向要定位外部脚本的第一行的位置。
请执行下列操作之一:
  • 在动作面板中,选择“导入脚本” 从面板菜单中,或者按Control+Shift+I (Windows)或Command+Shift+I (Macintosh)。

  • 在脚本窗口中,选择文件> 导入脚本或按Control+Shift+I (Windows)或Command+Shift+I (Macintosh)。

从“动作”中导出脚本 面板

选择要导出的脚本。 然后选择 从动作面板菜单导出脚本,或按Control+Shift+X (Windows)或Command+Shift+X (Macintosh)。
保存该 ActionScript (AS) 文件。

设置文本编码选项

选择“编辑”>“首选参数”(Windows) 或“Animate”>“首选参数”(Macintosh),然后在“类别”列表中选择“ActionScript”。

设置以下任何选项:

打开/导入

选择“UTF-8编码”以使用Unicode编码打开或导入。 或选择默认编码以使用该编码打开或导入 系统当前使用的语言的形式。

保存/导出

选择UTF-8编码以使用Unicode保存或导出 编码,或选择默认编码以使用 系统当前使用的语言的编码形式。

关闭导出编码警告 关闭或打开

选择“编辑”>“首选参数”(Windows) 或“Animate”>“首选参数”(Macintosh),然后在“类别”列表中选择“警告”。

选择或取消选择“导出时编码冲突警告” ActionScript文件。

(Animate中已弃用)导入和导出脚本的编码

您可以设置ActionScript首选项 指定在导入或导出的ActionScript中使用的编码类型 文件。 UTF-8编码是8位Unicode格式,它允许您包括 文件中的多种语言文本;默认编码为 系统当前使用的语言支持的编码, 也调用了传统代码页

注释

使用非英语应用程序时 在英语系统上,如果出现以下情况,“测试影片”命令将失败: SWF文件路径中包含无法使用无法表示的字符 多字节字符集(MBCS)编码方案。 例如, 日语路径在日语系统上起作用,但在英语系统上不起作用 系统。 请确保在英文系统中使用仅包含英文的路径名。 使用测试影片播放器的应用程序的所有区域均包括 且受此限制约束。

在动作面板中固定脚本

使用“固定脚本”功能可以固定脚本窗格中各个脚本的标签并相应移动它们。 此功能在您还没有将 FLA 文件中的代码组织到一个集中的位置或者在使用多个脚本时非常有用。

您可以将脚本固定,以保留代码在动作面板中的打开位置,然后在各个打开着的不同脚本中切换。 这在调试时特别有用。 

您还可以取消固定某个脚本或取消固定所有脚本,以便取消固定动作面板中的某个选定脚本,或者取消固定其中的所有脚本。

在下图中,与时间轴上当前位置关联的脚本位于名为“Cleanup”的图层的第 1 帧上。 (最左侧的选项卡始终在时间轴上您的位置的后面。) 该脚本还被固定,如最右侧选项卡所显示。 以下两个脚本被固定:

  • 在第 1 帧(Frame 1)上 
  • 在名为“Intro”的图层的第 15 帧(Frame 15)上

使用键盘快捷键或单击这些选项卡可以在各个固定的脚本之间移动。 在各个固定的脚本之间移动并不更改您在时间轴上的当前位置。 如果在动作脚本导航器中选中一个新的脚本,焦点将移到第一帧,即“Frame 1”。

注释

如果“脚本”窗格中的内容未进行相应更改来反映您在时间轴上选择的位置,则“脚本”窗格可能正显示一个固定的脚本。 单击“脚本”窗格左上角的当前帧选项卡可以显示与时间轴上的位置相关联的脚本。

固定的脚本

固定脚本

单击“时间轴”,使脚本出现在“动作”面板中“脚本”窗格左上角的当前帧选项卡内。

请执行下列操作之一:
  • 单击该选项卡右侧的图钉图标。
  • 选择“视图”>“固定脚本”来固定脚本。

 

取消固定所有脚本

在动作面板中选择固定的脚本。

选择“视图”>“取消固定脚本”,取消固定动作面板中选中的脚本。

选择“视图”>“取消固定所有脚本”,取消固定动作面板中的所有脚本。

取消固定选项

用于固定脚本的键盘快捷键

当插入点位于“脚本”窗格中时, 使用以下键盘快捷键可处理固定的脚本。

动作

Windows 

Macintosh

固定脚本

Control+Shift+=(等号)

Command+Shift+=

取消固定脚本

Control+Shift+-(减号)

Command+Shift+-

插入目标路径

多 脚本操作旨在影响影片剪辑、按钮及其他 元件实例。 在代码中,可以引用符号实例 在时间轴上插入目标路径 — 地址 要定位的实例的名称。 可以设置绝对 或相对目标路径。 绝对路径包含整个地址 实例的名称。 相对路径仅包含地址的一部分 与FLA中脚本本身的地址不同 文件,如果脚本移到另一个文件,则它将不再有效 位置。

在“动作”面板中,单击 脚本。
单击目标路径
输入目标实例的路径,或选择 列表中的目标。
选择绝对或相对路径选项。

使用代码提示

在动作面板或脚本窗口中工作时, 软件可以检测您正在输入的操作并显示代码 提示。 有两种类型的代码提示:工具提示包含 该动作的完整语法,以及列出该动作的 可能的ActionScript元素,如方法或属性名称 (有时称为代码完成的形式)。

代码 默认情况下,提示处于启用状态。 通过设置首选项,您可以禁用 代码提示或确定它们的显示速度。 当代码提示时 在首选项中禁用,您仍然可以手动显示代码 特定命令的提示。

注释

如果无法显示变量或对象的代码提示 您已在ActionScript 2.0中创建,但在ActionScript中启用了代码提示 首选参数中,确保给变量或对象命名的 适当的后缀,或者为变量使用了严格键入,或者 对象。

启用代码提示

您 可以通过多种方式触发代码提示。

严格指定对象的类型

在您使用 ActionScript 2.0,并严格指定基于内置类(例如 Button、Array 等)的变量的类型时,“脚本”窗格会为该变量显示代码提示。 例如,假设您输入以下两行代码:
var foo:Array = new Array();
foo.

输入句点(.)后,Animate会在弹出菜单中显示可用于Array对象的方法和属性的列表,因为您已将变量键入为数组。

后缀和代码提示

如果您使用的是 ActionScript 1.0,或者未严格指定对象的类型而又想显示这些对象的代码提示,请在创建每个对象时在其名称后添加一个后缀。 例如,触发 Camera 类的代码提示的后缀为 _cam。 假设您键入以下代码: var my_array = new Array(); var my_cam = Camera.get();

如果键入 my_cam,然后键入一个句点,就会显示 Camera 对象的代码提示。

对于在舞台上出现的对象,请使用“属性”检查器的“实例名称”框中的后缀。 例如,若要显示 MovieClip 对象的代码提示,请使用属性检查器为所有 MovieClip 对象指定带有 _mc 后缀的实例名称。 然后,每当您键入后跟句点的实例名称时,都会显示代码提示。
var my_array = new Array();
var my_cam = Camera.get();

注释

尽管后缀是 使用“严格键入”时触发代码提示不需要 对于对象,一致地使用后缀有助于生成代码 可以理解。

下表列出了后缀 在ActionScript 2.0中触发代码提示的代码:

对象类型

变量后缀

Array

_array

按钮

_btn

摄像头

_cam

Color

_color

ContextMenu

_cm

ContextMenuItem

_cmi

Date

_date

Error

_err

LoadVars

_lv

LocalConnection

_lc

Microphone

_mic

MovieClip

_mc

MovieClipLoader

_mcl

PrintJob

_pj

NetConnection

_nc

NetStream

_ns

SharedObject

_so

声音

_sound

String

_str

TextField

_txt

TextFormat

_fmt

视频

_video

XML

_xml

XMLNode

_xmlnode

XMLSocket

_xmlsocket

注释和代码提示

您也可以使用 ActionScript 注释来指定对象的类以便于进行代码提示。 在下面的示例中,注释告诉ActionScripttheObject实例的类是Object,依此类推。
//对象theObject;//数组theArray;//影片剪辑theMC;

如果 随后输入theMC,后跟一个句点, 显示MovieClip方法和属性列表的代码提示 出现。 如果输入theArray后跟一个句点, 显示Array方法和属性列表的代码提示 出现,等等。

但是,Adobe代替了这项技术 建议使用严格数据键入或后缀,因为 这些技术会自动启用代码提示并生成代码 更容易理解。

指定首选项设置 自动代码提示

  • 在动作面板或“脚本”窗口中,选择“编辑”>“首选参数”(Windows) 或“Animate”>“首选参数”(Macintosh),在“类别”列表中单击“代码编辑器”,然后启用或禁用“代码提示”。

(Animate中已弃用)指定代码提示的延迟

在动作面板或“脚本”窗口中,选择“编辑”>“首选参数”(Windows) 或“Animate”>“首选参数”(Macintosh)。

在“类别”列表中单击“ActionScript”。
使用滑块选择延迟的时间(以秒为单位)。

使用工具提示样式的代码提示

通过键入一个开口来显示代码提示 在需要括号的元素后面加括号“(”(用于 例如,在方法名称后面是ifdo..while之类的命令, 等等)。
左小括号调用代码提示

输入参数的值。

对于多个参数,请用逗号隔开各个值。 对于函数或语句,如for循环, 用分号分隔参数。

重载命令 (可以使用不同的函数集调用的函数或方法 参数),例如gotoAndPlay()对于显示 用于选择要设置的参数的指示器。 要选择参数,请单击小箭头或按Control+Left Arrow和Control+向右箭头。

一个代码提示含有多组参数

若要使代码提示消失,请执行下列操作之一:
  • 键入右小括号 “)”。

  • 单击该语句之外的地方。

  • 按下 Esc。

使用菜单样式的代码提示:

通过键入句点来显示代码提示 在变量或对象名称之后。
菜单样式的代码提示

若要浏览代码提示,请使用“向上”和“向下” 箭头键。
要在菜单中选择项目,请按Enter或Tab,或者 双击该项目。
若要使代码提示消失,请执行下列操作之一:
  • 选择一个菜单项。

  • 单击菜单窗口的上方或下方。

  • 如果已输入,请键入右括号“)” 键入了左括号“(”。

  • 按下 Esc。

手动显示代码提示

单击代码提示所在的代码位置 可能会出现,如在以下位置:
  • 在语句或命令之后的句点 (.) 跟在语句之后 或命令,其中必须输入属性或方法

  • 在方法名称中的小括号 [()] 之间

请执行下列操作之一:
  • 若要手动启用代码提示,请选择 “视图”>“显示代码提示”。

  • 按Control+空格键(Windows)或Command+空格键 (Macintosh)。

自定义类的代码提示

在创建自定义 ActionScript 3.0 类时,Animate 会解析这些类并确定其中包含的对象、属性和方法。 之后 Animate 便能够在您编写引用这些自定义类的代码时提供代码提示。 对于您通过 import 命令链接到任何其他代码的任何类,自定义类代码都是自动完成的。

代码提示功能可以提高开发人员的工作效率,因为他们无需记住类所使用的全部对象、方法和属性。 设计人员可以使用不是自己编写的类,因为他们不必掌握如何使用这些类的第一手知识。

代码提示包括:

  • 嵌套类引用的代码提示

    编写嵌套引用时,连续出现的代码提示协助很有帮助。

  • “this”的代码提示

    当在类文件中键入“this”时,您将获得该类的代码提示。

  • “new+<space>”的代码提示

    当键入“new+<space>”时,Animate 将显示可用类和包的列表。

  • “import”的代码提示

    键入“import + <space>”时,Animate 将显示所有内置包和自定义包的列表。

  • SWC 库的代码提示

    将 SWC 库添加到库路径或外部库路径时,Animate 将为该 SWC 文件中包含的所有类启用代码提示功能。