撰寫和管理指令碼

格式化程式碼

您的程式碼可以自動格式化和縮排 輸入時。 如果您使用動態字型對應，請確保 多語言文字會使用正確的字型。

設定自動格式化選項

根據自動格式化設定來格式化程式碼

• 按一下自動格式化 「動作」面板或「指令碼」視窗工具列。
• 從面板選單(位於 動作面板)，選取「自動格式化」。
• 按 Control+Shift+F (Windows) 或 Command+Shift+F (Macintosh)。
• 在Script視窗中，選取工具>自動 格式。

使用動態字體對應

使用自動縮排

為程式碼區段加上註解

程式碼註解是程式碼的一部分，而 ActionScript 編譯器會忽略這部分。 註解行會說明程式碼的作用，或者將不要刪除的程式碼暫時停用。 若要為某一行程式碼加上註解，請用雙斜線 (//) 當做這一行的開頭。 編譯器會將位於該行雙斜線後面的所有文字予以忽略。 您也可以在程式碼區塊的開頭放置斜線和星號 (/*)，並在程式碼區塊結尾放置星號和斜線 (*/)，為更大的程式碼區塊加上註解。

您可以手動輸入這些註解標記，或者使用位於「動作」面板或 Script 視窗上方的按鈕來加入註解標記。

為程式碼行加上註解

插入點上便會放置雙斜線 (//)。

加入多行程式碼的註解

區塊註解字元會放在開頭 (/*)和結尾部分(*/)。

移除註解

使用語法標色

在ActionScript語中，與任何語言一樣，語法是 元素被組合起來以創造意義的方式。 如果您使用 ActionScript語法不正確，您的指令碼無法運行。

收件者 反白語法錯誤，為部分指令碼設定顏色代碼。 例如，假設您將「語法著色」偏好設定設為 關鍵字以藍色顯示。 當您輸入var時， 文字var顯示為藍色。 然而，如果你誤以為 型別vae，單字vae仍然存在 黑色，表示您輸入錯誤。

執行下列其中一項：

• 選取「編輯 > 偏好設定」(Windows) 或「Animate > 偏好設定」(Macintosh)，接著按一下「類別」清單中的「程式碼編輯器」，再指定「語法標色」設定。

• 當插入點在「Script」窗格中時，請按 Control + U (Windows) 或 Command + U (Macintosh)。

使用識別碼和關鍵字 執行階段時列出

啟動 Animate 時，會從資源檔案讀取識別名稱和關鍵字清單，並加以快取。 除了從資源讀取預設清單以外，還會掃描「Preference」資料夾中的其他關鍵字和識別名稱清單。 您只要在下列資料夾中加入「.txt files」，就能加入其他關鍵字和識別名稱：

• 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]\

使用行號和文字換行

編輯或修改代碼時，行號 讓程式碼更易於捲動與剖析。 自動換行有助於避免 水準捲動長行程式碼(特別是當您工作時 在撰寫環境中，或以低熒幕解析度)。

啟用或停用行號

• 於 在「指令碼」視窗中，選取檢視>行號。
• 按 Control+Shift+L (Windows) 或 Command+Shift+L (Macintosh)。

反白標示特定的程式碼行

• 在「指令碼」視窗中，選取 「編輯」>「移至明細行」。

啟用或停用文字換行

• 在Script視窗中， 選取「檢視>自動換行」。
• 按 Control+Shift+W (Windows) 或 Command+Shift+W (Macintosh)。

顯示隱藏的字元

空格、定位字元、 分行符號隱藏在ActionScript代碼中。 您可能需要 顯示這些字元；例如，您必須尋找並移除 不屬於字串值的雙位元組空格，因為 它們會導致編譯器錯誤。

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

以下專案 符號用於顯示隱藏的字元。

尋找指令碼中的文字

「尋找」工具可讓您尋找和取代文字 指令碼中的字串。

尋找文字

尋找和取代指令碼中的文字

（不建議使用動畫）在「動作」面板中重複搜尋

（已停用，並加上動畫）在Script視窗中重複搜尋

(Animate 不建議使用) 檢查語法和標點符號

您可以快速檢查 不發佈FLA檔案的ActionScript碼。

時間 如果您檢查語法，則會檢查目前的指令碼。 如果目前 指令碼呼叫ActionScript類，也會檢查這些類。 但不會檢查其他可能位於 FLA 檔案中的指令碼。

用於 ActionScript 2.0檔案，Check Syntax通過編譯器運行代碼，生成 語法和編譯器錯誤。

對於ActionScript3.0檔案，請檢查 語法只會產生語法錯誤。 若要產生編譯器錯誤， 例如型別不匹配、不正確的返回值以及變數或方法 名稱拼字錯誤，您必須使用「控制>測試」命令。

檢查語法

若要檢查語法，請執行下列其中一項：

• 在「動作」面板或「指令碼」視窗中， 按一下「檢查語法」。
• 按一下[指令碼]窗格，然後按Control+T(Windows) 或Command+T(Macintosh)。 在「指令碼」窗格中按一下或輸入 讓它成為焦點。 如果「舞台」上的物件有焦點， 「變形」面板會開啟。

「編譯器錯誤」面板中會列出語法錯誤。

檢查成對的標點符號

（已使用動畫取代）匯入和匯出指令碼

您可以將指令碼匯入到 「動作」面板或「指令碼」視窗。 您也可以匯出指令碼 從「動作」面板到外部ActionScript檔案。 (當您 使用「指令碼」視窗，因為您可以 改為儲存AS檔案。)

如果 當您開啟或匯入時，指令碼中的文字看起來並不如預期 在檔案中，變更匯入編碼偏好設定。

匯入外部 AS 檔案

從「動作」匯出指令碼 面板

設定文字編碼選項

開啟匯出編碼警告 關閉或開啟

（已使用動畫取代）匯入和匯出指令碼的編碼

您可以設定ActionScript偏好設定 指定在匯入或匯出ActionScript中使用的編碼型別 檔案。 UTF-8編碼是8位元Unicode格式，可讓您包含 檔案中的多種語言文字；「預設編碼」是 系統目前使用的語言所支援的編碼， 也稱為傳統內碼表。

在動作面板中鎖定指令碼

使用「鎖定 Script」功能可以鎖定「Script」窗格中個別指令碼的標籤，並且據此加以移動。 如果您尚未將 FLA 檔案內的程式碼整理到一個集中的位置，或是您正在使用多個指令碼，這個功能會很有用。

您可以鎖定指令碼，以便在「動作」面板中保留程式碼的開放位置，並且在各種開啟的程式碼之間切換使用。 這個動作在除錯時特別有用。 

此外，您也可以取消鎖定指令碼或取消鎖定所有指令碼，以取消鎖定所選的指令碼或取消鎖定「動作」面板中的所有指令碼。

在下圖中，與時間軸上目前位置關聯的指令碼是位於 Cleanup 圖層的「影格 1」上 (最左邊的標籤會永遠跟隨您在時間軸上的位置)。 此外，指令碼也會鎖定顯示為最右邊的標籤。 下列是兩個已鎖定的指令碼：

• 在影格 1 
• 在名為 Intro 的圖層的影格 15

使用鍵盤快速鍵或按一下標籤，即可移動鎖定的指令碼。 在各個鎖定的指令碼之間移動時，並不會變更時間軸上的目前位置。 如果在「動作」指令碼導覽器中選取了新的指令碼，焦點就會移到第一個影格，例如「影格 1」。

鎖定指令碼

取消鎖定所有指令碼

鎖定指令碼的鍵盤快速鍵

當插入點在「指令碼」窗格中時， 使用下列鍵盤快速鍵來使用固定指令碼。

插入目標路徑

很多 指令碼動作會影響影片片段、按鈕和其他動作 符號例項。 在您的程式碼中，您可以參照符號例項 在時間軸上插入目標路徑 — 位址 您想要的目標執行個體。 您可以設定 或相對目標路徑。 絕對路徑包含整個位址 實體的。 相對路徑只包含地址的一部分 這與FLA中指令碼本身的地址不同 檔案，如果指令碼移至其他檔案，將無法再使用 位置。

使用程式碼提示

當您在「動作」面板或「指令碼」視窗中工作時， 軟體可以偵測您正在輸入的動作，並顯示程式碼 提示。 有兩種型別的程式碼提示：工具提示，包含 該動作的完整語法，以及列出動作清單的彈出式選單 可能的ActionScript元素，例如方法或屬性名稱 （有時稱為代碼完成的形式）。

代碼 提示預設為啟用。 透過設定偏好設定，您可以停用 程式碼提示或決定提示出現的速度。 當程式碼提示時 在偏好設定中停用，您仍然可以手動顯示程式碼 特定命令的提示。

啟用程式碼提示

您 能以各種方式觸發程式碼提示。

為物件進行嚴謹資料輸入

當您使用 ActionScript 2.0 而且針對以內建類別 (如 Button、Array 等) 為根據的變數使用嚴謹資料輸入時，「Script」窗格便會顯示該變數的程式碼提示。 例如，假設您輸入下列兩行程式碼：
var foo:Array = new Array();
foo.

一旦輸入句點(.)，「動畫」即會在彈出式選單中顯示可用於Array物件的方法和屬性清單，因為您輸入變數做為陣列。

字尾和程式碼提示

如果您使用的是 ActionScript 1.0，或者只要為沒有進行嚴謹類型轉換的物件顯示程式碼提示，則請在建立物件時為每個物件名稱加上字尾。 例如，觸發 Camera 類別之程式碼提示的字尾為 _cam。 假設您輸入下列程式碼： var my_array = new Array(); var my_cam = Camera.get();

如果接著輸入 my_cam 並緊接著句號，便會出現 Camera 物件的程式碼提示。

對於出現在「舞台」上的物件，請在「屬性」檢測器的「實體名稱」方塊中使用字尾。 例如，若要顯示 MovieClip 物件的程式碼提示，可以使用「屬性」檢測器，將內含 _mc 字尾的實體名稱指定給所有的 MovieClip 物件。 然後，只要輸入執行個體名稱后接句點，就會顯示程式碼提示。
var my_array = new Array();
var my_cam = Camera.get();

下表列出了字尾 會觸發ActionScript 2.0中的程式碼提示：

註解和程式碼提示

您也可以使用 ActionScript 註解，為程式碼提示指定物件的類別。 在下列範例中，註解會告知ActionScripttheObject執行個體的類別是Object，依此類推。
// Object theObject;// Array theArray;// MovieClip theMC;

如果 您接著輸入theMC，後面接著句號， 顯示MovieClip方法和屬性清單的程式碼提示 出現。 如果您輸入theArray後跟句點， 顯示陣列方法和屬性清單的程式碼提示 出現，依此類推。

然而，與這種技術不同，Adobe 建議您使用嚴格的資料輸入或尾碼，因為 這些技巧會自動啟用程式碼提示，並製作您的程式碼 更容易理解。

指定偏好設定 自動程式碼提示

• 在「動作」面板或「Script」視窗中，選取「編輯 > 偏好設定」(Windows) 或「Animate > 偏好設定」(Macintosh)，再按「類別」清單中的「程式碼編輯器」，然後啟用或停用「程式碼提示」。

（不建議使用動畫）指定程式碼提示的延遲

使用工具提示類型的程式碼提示

使用選單類型的程式碼提示：

手動顯示程式碼提示

自訂類別的程式碼提示

當您建立自訂 ActionScript 3.0 類別時，Animate 會剖析類別並判斷其中所包含的物件、屬性與方法。 如此一來，當您撰寫參考自訂類別的程式碼時，Animate 便能提供程式碼提示。 自訂類別程式碼會自動完成您要透過 import 命令連結至其他程式碼的任何類別。

程式碼提示可讓開發人員的工作速度變快，因為他們不必記住該類別使用的所有物件、方法及屬性。 設計人員可以使用他人所編寫的類別，因為設計人員並不需要對於如何使用該類別有直接的了解。

程式碼提示包括下列項目：

• 巢狀類別參考的程式碼提示

  當您編寫巢狀參考時，程式碼提示的持續協助會很有幫助。

• “this” 的程式碼提示

  在類別檔案中輸入 "this" 時，您便可取得相同類別的程式碼提示。

• “new+<space>” 的程式碼提示

  當您輸入「new+<space>」時，Animate 會顯示可用類別與套件的清單。

• “import” 的程式碼提示

  當您輸入「import + <space>」時，Animate 會顯示所有內建套件與自訂套件的清單。

• SWC 元件庫的程式碼提示

  當您將 SWC 元件庫新增至元件庫路徑或外部元件庫路徑時，Animate 可對包含於 SWC 檔案中的所有類別提供程式碼提示。

更多相關資訊

• 設定 ActionScript 偏好設定
• 使用影片結構檢視器
• 編譯及匯出類別 (ActionScript 2.0)
• ActionScript 3.0 的除錯