撰寫和管理指令碼

您可以將程式碼格式化，並在輸入時自動進行縮排。如果使用動態字體對應，便可確保有針對多國語言文字使用正確的字體。

設定自動格式化選項

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

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

使用動態字體對應

使用自動縮排

為程式碼區段加上註解

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

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

為程式碼行加上註解

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

加入多行程式碼的註解

區塊註解字元便會放在選取範圍的開頭 (/*) 和結尾 (*/)。

移除註解

使用語法標色

在 ActionScript 中和在其他語言中一樣，「語法」是將元素結合在一起以產生意義的方式。如果使用不正確的 ActionScript 語法，Script 將無法運作。

若要將語法錯誤反白標示，請將顏色編碼設為指令碼的一部分。例如，假設您設定語法標色偏好設定，好讓關鍵字顯示成藍色。當您輸入 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]\

使用行號和文字換行

當您編輯或修改程式碼時，行號可以讓程式碼更容易捲動和剖析。文字換行能讓您避免水平捲動過長的程式碼行 (特別是在編寫環境或低螢幕解析度下工作時)。

啟用或停用行號

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

反白標示特定的程式碼行

• 在 Script 視窗中，選取「編輯 > 前往行數」。

啟用或停用文字換行

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

顯示隱藏的字元

在 ActionScript 程式碼中，空格字元、定位鍵和斷行符號等都是隱藏的字元。您可能需要顯示這些字元，例如，您必須找出並移除不屬於字串值的雙位元組空格字元，因為這些字元會造成編譯器錯誤。

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

下列符號用於顯示隱藏的字元。

尋找指令碼中的文字

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

尋找文字

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

(Animate 不建議使用) 在動作面板中重複搜尋

(Animate 不建議使用) 在 Script 視窗中重複搜尋

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

您不需要發佈 FLA 檔案，便可以快速檢查 ActionScript 程式碼。

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

對 ActionScript 2.0 的檔案而言，「檢查語法」會透過編譯器執行程式碼，產生語法和編譯器錯誤。

對 ActionScript 3.0 的檔案而言，「檢查語法」只會造產生語法錯誤。若要產生編譯器錯誤 (例如類型不相符、不適當的傳回值，以及變數或方法名稱的拼字錯誤)，您必須使用「控制 > 測試」命令。

檢查語法

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

• 在「動作」面板或 Script 視窗中，按一下「檢查語法」。
• 按一下「Script」窗格，然後按 Control+T (Windows) 或 Command+T (Macintosh)。按一下「Script」窗格或在其中打字，將焦點帶回「Script」窗格。如果焦點是在「舞台」中的物件，則會改開啟「變形」面板。

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

檢查成對的標點符號

(Animate 不建議使用) 匯入和匯出指令碼

您可以將指令碼匯入「動作」面板或 Script 視窗，也可以從「動作」面板中將指令碼匯出至外部 ActionScript 檔案(使用 Script 視窗時，因為您可以另存成 AS 檔案，因此不需要匯出)。

如果在開啟或匯入檔案時，Script 中的文字看起來與預期的不同，請變更匯入編碼偏好設定。

匯入外部 AS 檔案

從動作面板中匯出指令碼

設定文字編碼選項

開啟或關閉匯出編碼警告

(Animate 不建議使用) 匯入和匯出的指令碼所用的編碼

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

在動作面板中鎖定指令碼

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

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

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

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

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

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

鎖定指令碼

取消鎖定所有指令碼

鎖定指令碼的鍵盤快速鍵

當插入點位於「Script」窗格時，請使用下列鍵盤快速鍵來處理鎖定的指令碼。

插入目標路徑

許多指令碼動作是要影響影片片段、按鈕和其他元件實體。在程式碼中，您可以插入「目標路徑」 (也就是要做為目標之實體的位址)，參考時間軸上的元件實體。您可以設定絕對或相對目標路徑。絕對路徑包含實體的整個位址。相對路徑只包含與 FLA 檔案中指令碼本身的位址不同的位址部分，而且如果將指令碼移至其他位置，相對路徑將不再有效。

使用程式碼提示

當您在「動作」面板或 Script 視窗中工作時，此軟體可以偵測出您所輸入的動作，並顯示程式碼提示。程式碼提示共分為兩種：一種是工具提示 (包含該動作的完整語法)，而另一種是彈出式選單，它會列出可能的 ActionScript 元素，例如方法或屬性名稱 (有時稱為「程式碼完成」的形式)。

預設會啟用程式碼提示。透過設定偏好設定，您可以停用程式碼提示，或是決定程式碼提示出現的速度。在偏好設定中停用程式碼提示後，您還是可以手動顯示特定命令的程式碼提示。

啟用程式碼提示

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

為物件進行嚴謹資料輸入

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

一旦您輸入句號 (.)，Animate 就會在彈出式選單中顯示 Array 物件可用的方法及屬性清單，因為您已將此變數當做陣列輸入。

字尾和程式碼提示

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

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

對於出現在「舞台」上的物件，請在「屬性」檢測器的「實體名稱」方塊中使用字尾。例如，若要顯示 MovieClip 物件的程式碼提示，可以使用「屬性」檢測器，將內含 _mc 字尾的實體名稱指定給所有的 MovieClip 物件。然後，每當您輸入實體名稱及跟隨的句號時，程式碼提示便會出現。

下表列出會在 ActionScript 2.0 中觸發物件提示的字尾：

註解和程式碼提示

您也可以使用 ActionScript 註解，為程式碼提示指定物件的類別。在下列範例中，註解會告知 ActionScript theObject 實體的類別為 Object，以此類推。

如果接著輸入 theMC 及其後的句號，便會出現程式碼提示，顯示著 MovieClip 方法及屬性的清單。如果接著輸入 theArray 並跟隨著句號，便會出現程式碼提示，其中會顯示 Array 方法及屬性的清單，以此類推。

不過，Adobe 建議您不要使用這個方法，而是改用嚴謹資料輸入或字尾，因為這些方法能自動啟用程式碼提示，也能讓程式碼更具可讀性。

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

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

(Animate 不建議使用) 指定程式碼提示的延遲時間

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

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

手動顯示程式碼提示

自訂類別的程式碼提示

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

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

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

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

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

• “this” 的程式碼提示

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

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

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

• “import” 的程式碼提示

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

• SWC 元件庫的程式碼提示

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