Creazione e gestione di script

Potete formattare e applicare rientri al codice in modo automatico quando digitate. Se utilizzate la mappatura dei caratteri dinamica, avete la garanzia che per il testo multilingue vengano utilizzati i caratteri corretti.

Impostare le opzioni di Formattazione automatica

Formattare il codice in base alle impostazioni di Formattazione automatica

• Fate clic su Formattazione automatica  nella barra degli strumenti del pannello Azioni o della finestra Script.
• Nel menu del pannello visualizzato nell'angolo superiore destro del pannello Azioni, selezionate Formattazione automatica.
• Premete Ctrl+Maiusc+F (Windows) o Comando+Maiusc+F (Macintosh).
• Nella finestra Script, selezionate Strumenti > Formattazione automatica.

Usare la mappatura dei caratteri dinamica

Usare il rientro automatico

Sezioni di commenti nel codice

I commenti del codice sono parti di codice che vengono ignorate dal compilatore ActionScript. Una riga di commento illustra lo scopo del codice oppure disattiva temporaneamente del codice, senza eliminarlo. Potete commentare una riga di codice iniziandola con la doppia barra (//). Il compilatore ignora il testo su quella riga che segue la doppia barra. Potete anche commentare blocchi di codice più grandi posizionando una barra e un asterisco (/*) all'inizio del blocco e un asterisco e una barra (*/) alla fine del blocco.

Potete digitare questi marcatori manualmente oppure utilizzare i pulsanti nella parte superiore del pannello Azioni o della finestra Script per aggiungerli.

Commentare una riga di codice

Una doppia barra (//) viene collocata nel punto di inserimento.

Commentare più righe di codice

I caratteri di blocco di commento vengono inseriti all'inizio (/*) e alla fine (*/) della selezione.

Rimuovere un commento

Usare la colorazione della sintassi

In ActionScript, come in tutti i linguaggi, la sintassi identifica il modo in cui gli elementi vengono combinati tra loro per produrre un significato. Se la sintassi di ActionScript è scorretta, lo script non funziona.

Per evidenziare gli errori di sintassi, impostate il codice di colorazione delle parti dello script. Potete, ad esempio, impostare la preferenza di colorazione della sintassi in modo che le parole chiave vengano visualizzate in blu. Durante la scrittura del codice, se si digita var, la parola var viene visualizzata in blu. Se invece per errore si digita vae, la parola vae resta in nero, consentendo di riconoscere immediatamente l'errore di digitazione.

Effettuate una delle seguenti operazioni:

• Selezionate Modifica > Preferenze (Windows) oppure Animate > Preferenze (Macintosh) e fate clic su Editor di codice nell’elenco Categoria, quindi specificate le impostazioni Colori sintassi.

• Con il punto di inserimento nel pannello Script, premete Ctrl+U in Windows o Comando+U in Macintosh.

Uso degli elenchi degli identificatori e delle parole chiave in fase di runtime

All’avvio di Animate, gli elenchi degli identificatori e delle parole chiave vengono letti dal file delle risorse e memorizzati in cache. Oltre a questa operazione di lettura, il programma cerca anche ulteriori parole chiave e identificatori nella cartella Preferenze. Potete aggiungere parole chiave e identificatori supplementari inserendo dei "file .txt" nelle seguenti cartelle:

• C:\Utenti\<nome utente>[AppData]\Roaming\Adobe\Animate\13.0[ActionscriptKeywords]\

• C:\Utenti\<nome utente>[AppData]\Roaming\Adobe\Animate\13.0[ActionscriptIdentifiers]\

• C:\Utenti\<nome utente>[AppData]\Roaming\Adobe\Animate\13.0[JavascriptKeywords]\

• C:\Utenti\<nome utente>[AppData]\Roaming\Adobe\Animate\13.0[JavascriptIdentifiers]\

Uso dei numeri di riga e del ritorno a capo automatico

Con i numeri di riga è più facile scorrere nel codice e analizzarlo nella fase di modifica. L'impostazione del ritorno a capo automatico evita la necessità di scorrere orizzontalmente in righe di codice lunghe, in particolare quando si lavora nell'ambiente di creazione o con basse risoluzioni di schermo.

Attivare o disattivare i numeri di riga

• Nella finestra Script, selezionate Visualizza > Numeri di riga.
• Premete Ctrl+Maiusc+L (Windows) oppure Comando+Maiusc+L (Macintosh).

Evidenziare una riga specifica

• Nella finestra Script, selezionate Modifica > Vai alla riga.

Attivare o disattivare la funzione di a capo automatico

• Nella finestra Script, selezionate Visualizza > A capo automatico.
• Premete Ctrl+Maiusc+B (Windows) oppure Comando+Maiusc+B (Macintosh).

Visualizzare i caratteri nascosti

Nel codice ActionScript i caratteri come gli spazi, le tabulazioni e le interruzioni di riga sono nascosti. Potreste avere la necessità di visualizzarli; ad esempio, dovete trovare e sostituire gli spazi a doppio byte che non fanno parte di un valore stringa, in quanto provocano errori di compilazione.

• Premete Ctrl+Maiusc+8 (Windows) oppure Comando+Maiusc+8 (Macintosh).

I simboli seguenti sono usati per visualizzare i caratteri nascosti.

Cercare testo in uno script

Lo strumento Trova consente di cercare e sostituire le stringhe di testo negli script.

Cercare testo

Cercare e sostituire testo in uno script

(Dichiarato obsoleto in Animate) Ripetere una ricerca nel pannello Azioni

(Dichiarato obsoleto in Animate) Ripetere una ricerca nella finestra Script

(Dichiarato obsoleto in Animate) Controllare la sintassi e la punteggiatura

Potete eseguire un controllo rapido del codice ActionScript senza pubblicare il file FLA.

Quando si controlla la sintassi, viene eseguita la verifica dello script corrente. Se questo script chiama delle classi ActionScript, queste vengono a loro volta verificate. Eventuali altri script presenti nel file FLA non vengono verificati.

Per i file ActionScript 2.0, il comando Controlla sintassi esegue il codice attraverso il compilatore, generando errori di sintassi e del compilatore.

Per i file ActionScript 3.0, Controlla sintassi genera solo errori di sintassi. Per generare errori del compilatore, ad esempio errori di mancata corrispondenza del tipo, valori restituiti non corretti o errori ortografici nei nomi di variabili o metodi, utilizzate il comando Controllo > Prova.

Controllare la sintassi

Per verificare la sintassi, effettuate una delle seguenti operazioni:

• Fate clic su Controlla sintassi  nel pannello Azioni o nella finestra Script.
• Fate clic nel riquadro dello script, quindi premete Ctrl+T (Windows) o Comando+T (Macintosh). Il riquadro dello script diventa attivo quando fate clic o scrivete al suo interno. Se è attivo un oggetto sullo stage, viene invece aperto il pannello Trasforma.

Gli errori di sintassi vengono elencati nel pannello Errori del compilatore.

Controllare la correttezza della punteggiatura

(Dichiarato obsoleto in Animate) Importare ed esportare gli script

Potete importare uno script nel pannello Azioni o nella finestra Script. Potete anche esportare gli script dal pannello Azioni a file ActionScript esterni. Quando usate la finestra Script, l'esportazione non è necessaria perché potete invece salvare il file AS.

Se il testo degli script non ha l'aspetto desiderato quando aprite o importate un file, modificate l'impostazione relativa alla codifica per le importazioni.

Importare un file AS esterno

Esportare uno script dal pannello Azioni

Impostare le opzioni di codifica testo

Attivare o disattivare l'avviso per la codifica di esportazione

(Dichiarato obsoleto in Animate) Codifica per script importati ed esportati

Potete impostare le preferenze ActionScript in modo che sia specificato il tipo di codifica da utilizzare per i file ActionScript importati o esportati. UTF-8 è un formato Unicode a 8 bit, che consente di includere nel file testo in più lingue; la codifica predefinita è la forma di codifica supportata dalla lingua corrente utilizzata dal sistema, denominata anche tabella codici tradizionale.

Bloccare gli script nel pannello Azioni

Utilizzate la funzione Blocca lo script per fissare schede di singoli script nel canvas Script e per spostarle di conseguenza. Questa funzione è utile se non avete organizzato il codice all’interno del file FLA in una posizione centrale o se utilizzate più script.

Potete bloccare uno script per mantenere la posizione del codice aperto nel pannello Azioni e alternare tra i diversi script aperti. Questa funzione può essere particolarmente utile nel debug. 

Potete inoltre sbloccare uno script o sbloccare tutti gli script per sbloccare uno script selezionato o tutti gli script dal pannello Azioni.

Nella figura seguente, lo script associato alla posizione corrente nella linea temporale si trova nel fotogramma 1 del livello denominato Cleanup (la posizione corrente nella linea temporale viene indicata nella scheda più a sinistra). Lo script è inoltre bloccato come indicato nella scheda più a destra. I seguenti due script sono bloccati:

• Nel fotogramma 1 
• Nel fotogramma 15 del livello denominato Intro

Utilizzate le scelte rapide da tastiera o fate clic sulle schede per spostarvi tra gli script bloccati. Tali spostamenti tra i vari script bloccati non modificano la posizione corrente nella linea temporale. Se nel Navigatore Actionscript è selezionato un nuovo script, il fotogramma attivo diventa il primo, ovvero il Fotogramma 1.

Bloccare uno script

Sbloccare tutti gli script

Tasti di scelta rapida per gli script bloccati

Quando il punto di inserimento è nel riquadro dello script, utilizzate i seguenti tasti di scelta rapida per lavorare con gli script bloccati.

Inserire percorsi target

Molte delle azioni create nello script hanno lo scopo di incidere sui clip filmato, i pulsanti e altre istanze di simboli. Potete fare riferimento alle istanze di simboli in una linea temporale del codice, inserendo un percorso target, vale a dire l'indirizzo dell'istanza che si vuole usare come destinazione. Potete impostare un percorso assoluto o un percorso relativo. Un percorso assoluto contiene l'intero indirizzo dell'istanza, un percorso relativo contiene solo la parte dell'indirizzo che differisce dall'indirizzo dello script stesso nel file FLA e non funziona se lo script viene spostato in una diversa posizione.

Usare i suggerimenti sul codice

Quando si lavora nel pannello Azioni o nella finestra Script, il software è in grado di rilevare il tipo di azione che state eseguendo e visualizzare un suggerimento sul codice. Esistono due tipi di suggerimento sul codice: le descrizioni dei comandi, che contengono la sintassi completa di quell'azione, e un menu a comparsa nel quale sono elencati gli elementi ActionScript possibili, come nomi di proprietà e metodi (definito anche forma di completamento del codice).

I suggerimenti sul codice sono attivi per impostazione predefinita. Quando impostate le preferenze, potete disattivare i suggerimenti sul codice o determinarne la velocità di visualizzazione. Quando i suggerimenti sul codice sono disattivati nelle preferenze, è comunque possibile attivare manualmente la visualizzazione di un suggerimento sul codice per un comando specifico.

Attivazione dei suggerimenti sul codice

Potete attivare i suggerimenti sul codice in diversi modi:

Tipizzazione forte degli oggetti

Quando utilizzate ActionScript 2.0 e adottate la tipizzazione forte dei dati per una variabile basata su una classe incorporata, ad esempio Button, Array e così via, il riquadro dello script visualizza i suggerimenti sul codice per la variabile. Ad esempio, supponete di digitare le due righe seguenti di codice:

Non appena viene digitato il punto (.), Animate visualizza un elenco di metodi e proprietà disponibili per gli oggetti Array in un menu a comparsa, in quanto la variabile è stata digitata come un array.

Suffissi e suggerimenti sul codice

Se utilizzate ActionScript 1.0 o desiderate visualizzare i suggerimenti sul codice per gli oggetti creati senza tipizzazione forte, è necessario aggiungere un suffisso al nome di ogni oggetto al momento della sua creazione. Ad esempio, il suffisso che attiva il suggerimento del codice per la classe Camera è _cam. Supponete di digitare il codice seguente: var my_array = new Array(); var my_cam = Camera.get();

Se digitate my_cam seguito da un punto, vengono visualizzati i suggerimenti sul codice per l'oggetto Camera.

Per gli oggetti che vengono visualizzati sullo stage, utilizzate il suffisso nella casella Nome istanza della finestra di ispezione Proprietà. Ad esempio, per visualizzare i suggerimenti sul codice per gli oggetti MovieClip, utilizzate la finestra di ispezione Proprietà per assegnare i nomi di istanza con il suffisso _mc a tutti gli oggetti MovieClip. Quindi, ogni volta che digitate il nome di istanza seguito da un punto, vengono visualizzati i suggerimenti sul codice.

La tabella seguente elenca i suffissi di attivazione dei suggerimenti sul codice in ActionScript 2.0.

Commenti e suggerimenti sul codice

Potete inoltre usare i commenti di ActionScript per specificare la classe di un oggetto per i suggerimenti sul codice. Nell'esempio seguente un commento indica ad ActionScript che la classe dell'istanza theObject è Object e così via.

Se successivamente digitate theMC seguito da un punto, vengono visualizzati suggerimenti sul codice contenenti l'elenco dei metodi e delle proprietà di MovieClip. Se digitate theArray seguito da un punto, vengono visualizzati suggerimenti sul codice contenenti l'elenco dei metodi e delle proprietà di Array e così via.

Invece di questa tecnica, però, Adobe consiglia l'uso della tipizzazione forte dei dati oppure dei suffissi, perché queste due tecniche attivano automaticamente i suggerimenti, rendendo il codice più comprensibile.

Definire le impostazioni delle preferenze per i suggerimenti sul codice automatici

• Nel pannello Azioni o nella finestra Script, selezionate Modifica > Preferenze (Windows) o Animate > Preferenze (Macintosh), fate clic su Editor di codice nell’elenco Categoria, quindi abilitate o disabilitate Suggerimenti codice.

(Dichiarato obsoleto in Animate) Specificare un ritardo per i suggerimenti sul codice

Usare i suggerimenti sul codice sotto forma di descrizioni comandi

Usare i suggerimenti sul codice sotto forma di menu

Visualizzare manualmente un suggerimento sul codice

Suggerimenti sul codice per le classi personalizzate

Quando create classi ActionScript 3.0 personalizzate, Animate le analizza e determina quali oggetti, proprietà e metodi esse includono, dopo di che è in grado di fornire suggerimenti sul codice quando scrivete codice che fa riferimento alle classi personalizzate. Il completamento del codice delle classi personalizzate è automatico per qualunque classe che associate a qualsiasi altro codice mediante il comando import.

I suggerimenti sul codice permettono agli sviluppatori di lavorare più velocemente perché non devono ricordare tutti gli oggetti, le proprietà e i metodi utilizzati da una classe. A loro volta, i designer possono lavorare con classi che non hanno scritto personalmente perché non devono necessariamente avere una conoscenza di prima mano dei meccanismi di funzionamento di una classe.

I suggerimenti sul codice includono:

• Suggerimenti per i riferimenti di classe nidificati

  Quando scrivete dei riferimenti nidificati, la disponibilità immediata di suggerimenti sul codice è estremamente utile.

• Suggerimenti sul codice per "this"

  Quando scrivete "this" in un file di classe, vengono visualizzati i suggerimenti per quella classe specifica.

• Suggerimenti sul codice per "new+<spazio>"

  Quando digitate “new+<spazio>”, Animate visualizza un elenco di classi e pacchetti disponibili.

• Suggerimenti sul codice per "import"

  Quando digitate “import+<spazio>”, Animate visualizza un elenco di tutti i pacchetti incorporati e personalizzati.

• Suggerimenti per le librerie personalizzate

  Quando aggiungete una libreria SWC al percorso di libreria o al percorso di libreria esterno, Animate abilita i suggerimenti sul codice per tutte le classi incluse nel file SWC.