Pisanie skryptów i zarządzanie nimi

Kod może być formatowany i rozmieszczany (wcięcia) automatycznie podczas pisania. Zaleca się korzystanie z dynamicznego odwzorowywania czcionek, ponieważ zapewnia ono poprawny wybór czcionek w przypadku tekstów wielojęzycznych.

Ustawianie opcji automatycznego formatowania

Formatowanie kodu zgodnie z ustawieniami automatycznego formatowania

• Na pasku narzędzi panelu Operacje lub okna Skrypt kliknij przycisk Autoformatowanie .
• Przejdź do menu panelu (w prawym górnym rogu panelu Operacje) i wybierz polecenie Auto-format.
• Naciśnij klawisze Control+Shift+F (Windows) lub Command+Shift+F (Mac OS).
• W oknie Skrypt wybierz polecenie Narzędzia > Auto-format.

Używanie dynamicznego odwzorowywania czcionek

Używanie automatycznych wcięć

Sekcje komentarzy do kodu

Komentarze do kodu są to fragmenty kodu pomijane przez kompilator języka ActionScript. Komentarze zawierają pewne wyjaśnienia. Za ich pomocą można także wycinać ze skryptu kod, którego z jakichś powodów nie można usunąć na stałe. Pojedyncza linia kodu stanowi komentarz, jeśli zaczyna się od podwójnego ukośnika (//). Kompilator ignoruje wszystkie linie tak oznaczone. Aby komentarz obejmował większy fragment kodu, należy umieścić na jego początku ukośnik i gwiazdkę (/*), a na końcu gwiazdkę i ukośnik (*/).

Wymienione znaczniki komentarzy można wprowadzić ręcznie lub za pomocą przycisków dostępnych u góry panelu Operacje lub okna Skrypt.

Komentowanie linii kodu

W punkcie wstawiania pojawi się podwójny ukośnik (//).

Komentowanie wielu linii kodu

Na początku zaznaczenia zostanie umieszczony znak początku komentarza (/*), a na końcu — znak końca komentarza (*/).

Usuwanie komentarza

Kolorowanie konstrukcji składniowych

W języku ActionScript, podobnie jak w każdym innym języku, obowiązuje pewna składnia, czyli zbiór reguł odpowiedzialnych za konstruowanie złożonych wyrażeń językowych. Skrypty ActionScript o nieprawidłowej składni nie działają.

Wykrywane w skryptach błędy składniowe można wyróżniać określonymi kolorami. Załóżmy dla przykładu, że określono preferencję kolorowania słów kluczowych na niebiesko. Po wpisaniu poprawnego słowa kluczowego, czyli var, słowo var zostanie wyróżnione kolorem niebieskim. Jeśli jednak omyłkowo zostanie wpisane niepoprawne słowo kluczowe vae, słowo to, czyli vae pozostanie czarne. W ten sposób będzie można dostrzec błąd.

Wykonaj jedną z następujących czynności:

• Wybierz polecenie Edycja > Preferencje (Windows) lub Animate > Preferencje (Mac OS), kliknij opcję Edytor kodu na liście kategorii, a następnie określ ustawienia kolorowania składni.

• Gdy punkt wstawiania znajduje się w okienku Skrypt naciśnij klawisze Control-U (Windows) lub Command-U (Mac OS).

Używanie listy identyfikatorów i słów kluczowych w czasie działania

Podczas uruchamiania program Animate wczytuje listy identyfikatorów i słów kluczowych z pliku zasobów i umieszcza je w buforze. Poza odczytem list domyślnych z zasobów jest skanowany folder Preference w poszukiwaniu listy dodatkowych słów kluczowych i identyfikatorów. Umieszczając pliki TXT w następujących folderach, można dodawać słowa kluczowe i identyfikatory:

• C:\Użytkownicy\<nazwa użytkownika>\[AppData]\Roaming\Adobe\Animate\13.0[ActionscriptKeywords]\

• C:\Użytkownicy\<nazwa użytkownika>\[AppData]\Roaming\Adobe\Animate\13.0[ActionscriptIdentifiers]\

• C:\Użytkownicy\<nazwa użytkownika>\[AppData]\Roaming\Adobe\Animate\13.0[JavascriptKeywords]\

• C:\Użytkownicy\<nazwa użytkownika>\[AppData]\Roaming\Adobe\Animate\13.0[JavascriptIdentifiers]\

Używanie numerów linii i zawijania linii

Numery linii ułatwiają przeglądanie kodu i sprawdzanie jego poprawności. Funkcja zawijania pozwala uniknąć zbyt długich linii kodu, które trzeba przewijać w poziomie (jest ona szczególnie przydatna przy niskiej rozdzielczości ekranu).

Włączanie lub wyłączanie numerów linii

• W oknie Skrypt wybierz polecenie Widok > Numery linii.
• Naciśnij klawisze Control+Shift+L (Windows) lub Command+Shift+L (Mac OS).

Wyróżnianie konkretnej linii

• W oknie Skrypt wybierz polecenie Edycja > Przejdź do linii.

Włączanie lub wyłączanie zawijania linii

• W oknie Skrypt wybierz polecenie Widok > Zawijanie tekstu.
• Naciśnij klawisze Control+Shift+W (Windows) lub Command+Shift+W (Mac OS).

Wyświetlanie znaków ukrytych

W kodzie ActionScript są ukrywane takie znaki, jak spacje, znaki tabulacji i znaki podziału linii. W pewnych sytuacjach może wystąpić konieczność wyświetlenia takich znaków, na przykład, kiedy trzeba odszukać spacje dwubajtowe powodujące błędy na etapie kompilacji.

• Naciśnij klawisze Control+Shift+8 (Windows) lub Command+Shift+8 (Mac OS).

Do wyświetlania znaków ukrytych są używane następujące symbole.

Wyszukiwanie tekstu w skrypcie

Narzędzie Znajdź pozwala znajdować i zastępować w skrypcie ciągi tekstowe.

Wyszukiwanie tekstu

Wyszukiwanie i zastępowanie tekstu w skrypcie

(Przestarzałe w programie Animate) Powtarzanie wyszukiwania w panelu Operacje

(Przestarzałe w programie Animate) Powtarzanie wyszukiwania w oknie Skrypt

(Przestarzałe w programie Animate) Sprawdzenie składni i interpunkcji

Poprawność kodu ActionScript można sprawdzać bez publikowania pliku FLA.

Sprawdzanie składni obejmuje zawsze bieżący skrypt. Jeśli bieżący skrypt wywołuje klasy ActionScript, również te klasy są sprawdzane. Inne skrypty znajdujące się w pliku FLA nie są sprawdzane.

W przypadku plików w języku ActionScript 2.0 funkcja Sprawdzanie składni uruchamia kod na poziomie kompilatora, generując raporty o błędach składni i kompilatora.

W przypadku plików w języku ActionScript 3.0 funkcja Sprawdzanie składni generuje jedynie raporty na temat błędów składni. Aby wygenerować raporty o błędach kompilatora, dotyczące na przykład niezgodności typu, nieprawidłowych wartości zwracanych, niepoprawnie wpisanych nazw metod lub zmiennych, należy użyć polecenia Sterowanie > Testuj.

Sprawdzanie składni

Aby sprawdzić składnię, wykonaj jedną z następujących czynności:

• W panelu Operacje lub oknie Skrypt kliknij przycisk Sprawdź składnię .
• Kliknij w panelu Skrypt, a następnie naciśnij klawisze Control+T (Windows) lub Command+T (Mac OS). Kliknięcie lub rozpoczęcie pisania w panelu Skrypt powoduje, że staje się on aktywny. Jeśli aktywny był obiekt na stole montażowym, zamiast panelu Skrypt otwierany jest panel Przekształć.

Błędy składniowe są wyświetlane w panelu Błędy kompilatora.

Sprawdzanie poprawności interpunkcji

(Przestarzałe w programie Animate) Importowanie i eksportowanie skryptów

Skrypty mogą być importowane do panelu Operacje lub okna Skrypt. Skrypty opracowywane w panelu Operacje mogą też być eksportowane do zewnętrznych plików ActionScript. (Jeśli jest używane okno Skrypt, eksportowanie jest zbędne, ponieważ skrypt można zapisać w postaci pliku AS.)

Jeśli po otwarciu lub zaimportowaniu pliku zawarte w nim skrypty nie wyglądają tak jak powinny, należy zmienić preferencję kodowania danych importowanych.

Importowanie zewnętrznego pliku AS

Eksportowanie skryptu z panelu Operacje

Ustawianie opcji kodowania tekstu

Włączanie lub wyłączanie ostrzeżenia o kodowaniu

(Przestarzałe w programie Animate) Kodowanie importowanych i eksportowanych skryptów

Za pomocą preferencji języka ActionScript można określić typ kodowania, jaki ma obowiązywać w importowanych i eksportowanych plikach ActionScript. Kodowanie UTF‑8 odpowiada 8-bitowemu formatowi Unicode, który pozwala umieścić w pliku tekst wielojęzyczny; Kodowanie domyślne jest to kodowanie obsługiwane przez język używany aktualnie w systemie (obsługiwane przez tzw. tradycyjną stronę kodową).

Przypinanie skryptów w panelu Operacje

Funkcja dołączania skryptów umożliwia przypinanie zakładek poszczególnych skryptów w okienku Skrypt i pozwala przenosić je w odpowiedni sposób. Ta funkcja jest przydatna, jeśli nie uporządkowano kodu w pliku FLA w jednej, centralnej lokalizacji albo jest używanych wiele skryptów.

Skrypt można przypiąć na potrzeby zachowania otwartej lokalizacji w kodzie w panelu Operacje oraz przełączania się między otwartymi skryptami. Funkcja ta jest szczególnie przydatna podczas debugowania. 

Skrypt lub skrypty można odpiąć od zaznaczonego skryptu. Można również odpiąć wszystkie skrypty od panelu Operacje.

Na poniższym rysunku pokazano skrypt skojarzony z aktualną pozycją na osi czasu, czyli klatką nr 1 na warstwie Cleanup. Ostatnia zakładka po lewej stronie zawsze odnosi się do bieżącego położenia skryptu na osi czasu. Skrypt ten jest również przypięty (odpowiada mu ostania zakładka po prawej stronie). Następujące skrypty są przypięte:

• W klatce 1
• W klatce 15 warstwy o nazwie Intro

W celu przechodzenia między przypiętymi skryptami można używać skrótów klawiaturowych lub klikać ich zakładki. Przechodzenie między przypiętymi skryptami nie powoduje zmian ich położenia na osi czasu.Jeśli w nawigatorze skryptów ActionScript zostanie wybrany nowy skrypt, punkt skupienia zostanie przeniesiony do pierwszej klatki (klatki 1).

Przypinanie skryptu

Odpinanie wszystkich skryptów

Skróty klawiszowe dotyczące przypiętych skryptów

Jeśli punkt wstawiania znajduje się w okienku Skrypt, pewne operacje na przypiętych skryptach można wykonywać za pomocą następujących skrótów klawiszowych:

Wstawianie ścieżek docelowych

Wiele skryptów ma wpływ na działanie klipów filmowych, przycisków i symboli. Odwołania do tych obiektów są reprezentowane w kodzie przez tzw. ścieżki docelowe—czyli adresy obiektów docelowych. Ścieżki docelowe dzielą się na bezwzględne i względne. Ścieżka bezwzględna zawiera cały adres obiektu. Ścieżka względna zawiera tylko część adresu (nie jest to adres samego skryptu z pliku FLA). Po przeniesieniu skryptu w inne miejsce adres względny traci swoje znaczenie.

Korzystanie ze wskazówek do kodu

Jeśli użytkownik korzysta z panelu Operacje lub okna Skrypt, program może rozpoznawać wprowadzane operacje i wyświetlać wskazówki do kodu. Należy odróżnić dwa rodzaje wskazówek do kodu: podpowiedzi opisujące pełną składnię operacji oraz wyskakujące menu, zawierające listę dostępnych elementów języka ActionScript, np metod lub właściwości (jest to pewna forma uzupełniania kodu).

Wskazówki do kodu są włączone domyślnie. Za pomocą odpowiednich preferencji można je wyłączyć lub określić szybkość ich wyświetlania. Nawet jeśli wybierze się preferencję wyłączonych wskazówek, będzie je można włączać za pomocą odpowiedniego polecenia.

Włączanie podpowiedzi do kodu

Wskazówki do kodu mogą być wywoływane na różne sposoby:

Ścisłe typowanie obiektów

Jeśli jest używany język ActionScript 2.0 i jest definiowana zmienna oparta na wbudowanej klasie (np. Button lub Array), w okienku Skrypt są wyświetlane wskazówki do kodu dotyczącego zmiennej. Załóżmy dla przykładu, że wprowadzono dwie linie kodu:

Natychmiast po wpisaniu kropki (.), program Animate wyświetli menu podręczne z listą metod i właściwości dostępnych dla obiektów typu Array (ponieważ zmienną zdefiniowano jako tablicę).

Sufiksy i wskazówki do kodu

Jeśli jest używany język ActionScript 1.0 lub zachodzi potrzeba wyświetlania wskazówek dla obiektów bez ich ręcznego wpisywania, do nazw tworzonych obiektów można dodawać sufiksy. Na przykład, sufiks wywołujący wskazówkę dotyczącą klasy Camera to _cam. Załóżmy, ze wpisano następujący kod: var my_array = new Array(); var my_cam = Camera.get();

Jeśli zostanie wpisana fraza my_cam, a po niej kropka, pojawią się wskazówki dotyczące obiektu Camera.

W przypadku obiektów wyświetlanych na stole montażowym sufiksy należy wpisywać w oknie Inspektor właściwości, w polu Nazwa sufiksu. Na przykład, aby były wyświetlane wskazówki dla obiektów MovieClip, należy przypisać - za pomocą Inspektora właściwości - do wszystkich obiektów MovieClip nazwy z sufiksami _mc. Dzięki temu po każdym wpisaniu nazwy obiektu zakończonej kropką, będzie wyświetlana wskazówka do kodu.

W poniższej tabeli zestawiono sufiksy wywołujące wskazówki do kodu ActionScript 2.0:

Komentarze i wskazówki do kodu

W kodzie ActionScript można wstawiać komentarze określające klasę obiektu. Komentarze takie są brane pod uwagę przy wyświetlaniu wskazówek do kodu. W poniższym przykładzie komentarz informuje o tym, że klasą obiektu theObject jest Object (i podobnie dla kolejnych obiektów).

Jeśli użytkownik wprowadzi frazę theMC, a po niej kropkę, pojawi się wskazówka do kodu zawierająca listę metod i właściwości klasy MovieClip. Jeśli użytkownik wprowadzi frazę theArray, a po niej kropkę, pojawi się wskazówka do kodu zawierająca listę metod i właściwości klasy Array (i podobnie dla kolejnych obiektów).

Firma Adobe zaleca jednak, aby zamiast tej techniki stosować bezpośrednie wpisywanie danych lub sufiksy. Metody te pozwalają bowiem automatycznie wyświetlać wskazówki do kodu, a ponadto czynią od bardziej przejrzystym.

Określanie preferencji dotyczących automatycznych wskazówek do kodu

• W panelu Operacje lub oknie Skrypt wybierz polecenie Edycja > Preferencje (Windows) lub Animate > Preferencje (Mac OS), kliknij opcję Edytor kodu na liście kategorii, po czym włącz lub wyłącz opcję Wskazówki do kodu.

(Przestarzałe w programie Animate) Określanie opóźnienia wskazówek do kodu

Korzystanie ze wskazówek do kodu w formie podpowiedzi

Korzystanie ze wskazówek do kodu w formie menu:

Ręczne wyświetlanie wskazówki do kodu

Podpowiedzi do kodu klas użytkownika

Gdy użytkownik tworzy własne klasy w języku ActionScript 3.0, program Animate analizuje składnię tych klas i określa, jakie obiekty, właściwości i metody są w nich zawarte. Na tej podstawie program Animate może następnie wyświetlać podpowiedzi do kodu odwołującego się do klas niestandardowych. Uzupełnianie kodu odbywa się automatycznie we wszystkich klasach powiązanych z jakimkolwiek innym kodem za pomocą polecenia import.

Podpowiedzi do kodu przyspieszają pracę programistów, ponieważ dzięki nim nie trzeba pamiętać nazw obiektów, metod ani właściwości używanych w klasie. Projektanci mogą używać klas, których sami nie napisali i których gruntownie nie znają.

Wyróżnia się następujące rodzaje podpowiedzi do kodu:

• Podpowiedzi do zagnieżdżonych odniesień do klas

  Podpowiedzi do kodu są szczególnie przydatne podczas pisania zagnieżdżonych odwołań.

• Podpowiedzi do słowa kluczowego „this”

  Wpisanie słowa „this” w pliku klasy powoduje wyświetlenie podpowiedzi dotyczącej tej właśnie klasy.

• Podpowiedzi do kodu „new+<spacja>”

  Po wpisaniu kodu „new+<spacja>” w programie Animate wyświetlana jest lista dostępnych klas i pakietów.

• Podpowiedzi do słowa kluczowego „import”

  Po wpisaniu kodu „import + <spacja>” w programie Animate wyświetlana jest lista wszystkich pakietów wbudowanych i niestandardowych.

• Podpowiedzi do kodu bibliotek SWC

  Gdy biblioteka SWC zostanie dodana do ścieżki bibliotek zewnętrznych, w programie Animate możliwe będzie wyświetlanie podpowiedzi do kodu wszystkich klas zawartych w pliku SWC.