Cómo escribir y gestionar scripts

Se puede aplicar formato al código y sangrarlo de forma automática mientras lo escribe. La utilización de asignación dinámica de fuentes garantiza el uso de las fuentes correctas cuando se trabaja con textos multilingües.

Establecimiento de las opciones de Formato automático

Aplicación de formato en función de las opciones de Formato automático

• Haga clic en Formato automático  del panel Acciones o en la barra de herramientas de la ventana Script.
• En el menú Panel (en la esquina superior derecha del panel Acciones), seleccione Formato automático.
• Presione Ctrl+Mayús+F (Windows) o Comando+Mayúsculas+F (Macintosh).
• En la ventana Script, seleccione Herramientas > Formato automático.

Utilización de asignación dinámica de fuentes

Utilización de sangría automática

Comentarios de secciones de código

Los comentarios de código son partes del código que el compilador de ActionScript ignora. Una línea de comentario explica lo que hace el código, o desactiva temporalmente código que no desea eliminar. Para aplicar un comentario a una línea de código, iníciela con una barra diagonal (//). El compilador omite todo el texto de esa línea que sigue a la barra diagonal. También puede aplicar comentarios a bloques de código más grandes colocando una barra y un asterisco (/*) al principio del bloque, y un asterisco y una barra (*/) al final del mismo.

Puede escribir estos marcadores de comentario de forma manual o utilizar los botones de la parte superior del panel Acciones o de la ventana Script para añadirlos.

Comentario de una línea de código

Se coloca una barra diagonal (//) en el punto de inserción.

Comentario de varias líneas de código

Los caracteres del comentario de bloque se sitúan al principio (/*) y al final (/*) de la selección.

Eliminación de un comentario

Utilización de colores para la sintaxis

En ActionScript, como en cualquier lenguaje, la sintaxis es la manera en la que los elementos se agrupan para crear un significado. Si utiliza una sintaxis de ActionScript incorrecta, los scripts no funcionarán.

Para resaltar errores de sintaxis, establezca un código de color para partes de los scripts. Por ejemplo, supongamos que establece la preferencia de coloreado de la sintaxis de tal modo que las palabras clave se muestren en color azul. Cuando escriba var, la palabra var aparecerá en azul. No obstante si, por error, escribe vae, la palabra vae permanecerá de color negro, con lo cual usted sabrá inmediatamente que la ha escrito incorrectamente.

Realice uno de los siguientes pasos:

• Seleccione Edición > Preferencias (Windows) o Animate > Preferencias (Macintosh), haga clic en Editor de código en la lista Categoría y especifique la configuración de Colores de sintaxis.

• Con el puntero del ratón en el panel Script, presione Control-U (Windows) o Comando-U (Macintosh).

Utilización de la lista de identificadores y palabras clave en tiempo de ejecución

Al abrir Animate, las listas de identificadores y palabras clave se leen desde el archivo de recursos y se almacenan en la memoria caché. Además de leer las listas predeterminadas desde el recurso, también se buscan nuevas listas de palabras clave y de identificadores en la carpeta de preferencias. Es posible añadir palabras clave e identificadores adicionales si agrega "archivos .txt" en las siguientes carpetas:

• C:\Users\<nombre de usuario>[AppData]\Roaming\Adobe\Animate\13.0[ActionscriptKeywords]\

• C:\Users\<nombre de usuario>[AppData]\Roaming\Adobe\Animate\13.0[ActionscriptIdentifiers]\

• C:\Users\<nombre de usuario>[AppData]\Roaming\Adobe\Animate\13.0[JavascriptKeywords]\

• C:\Users\<nombre de usuario>[AppData]\Roaming\Adobe\Animate\13.0[JavascriptIdentifiers]\

Utilización de números de línea y ajuste de texto

Cuando edita o modifica código, los números de línea facilitan el desplazamiento y el análisis. El ajuste de texto ayuda a evitar tener que desplazarse horizontalmente por largas líneas de código (especialmente cuando trabaja en el entorno de edición o con resoluciones de pantalla bajas).

Activación y desactivación de números de línea

• En la ventana Script, seleccione Ver > Números de línea.
• Presione Ctrl+Mayús+L (Windows) o Comando+Mayúsculas+L (Macintosh).

Resaltado de una línea específica

• En la ventana Script, seleccione Herramientas > Ir a la línea.

Activación o desactivación del ajuste de texto

• En la ventana Script, seleccione Ver > Ajustar texto.
• Presione las teclas Ctrl+Mayús+W (Windows) o Comando+Mayúsculas+W (Macintosh).

Visualización de caracteres ocultos

Los caracteres ocultos como espacios, tabuladores y saltos de línea están ocultos en el código ActionScript. Es posible que necesite visualizarlos; por ejemplo, debe buscar y quitar los espacios de doble byte que no forman parte de un valor de cadena, ya que éstos provocan errores del compilador.

• Presione Ctrl+Mayús+8 (Windows) o Comando+Mayúsculas+8 (Macintosh).

Los siguientes símbolos se utilizan para mostrar cada uno de los caracteres ocultos.

Búsqueda de texto en un script

La herramienta Buscar le permite localizar y reemplazar cadenas de texto en los scripts.

Búsqueda de texto

Búsqueda y sustitución de texto en un script

(En desuso en Animate) Repetición de una búsqueda en el panel Acciones

(En desuso en Animate) Repetición de una búsqueda en la ventana Script

(En desuso en Animate) Revisión de la sintaxis y la puntuación

Puede realizar una comprobación rápida del código ActionScript sin publicar el archivo FLA.

Cuando se revisa la sintaxis, se comprueba el script actual. Si el script activo llama a clases de ActionScript, éstas también se revisarán. Los demás scripts que puedan encontrarse en el archivo FLA no se revisan.

En el caso de archivos de ActionScript 2.0, la comprobación de sintaxis ejecuta el código en el compilador, por lo que se generan errores de sintaxis y de compilador.

En archivos de ActionScript 3.0, la comprobación de sintaxis genera únicamente errores de sintaxis. Para poder generar errores de compilador, como discordancias de tipos, valores devueltos no válidos y nombres de métodos o de variables mal escritos, utilice el comando Control > Probar.

Revisión de la sintaxis

Para comprobar la sintaxis, realice una de las acciones siguientes:

• Haga clic en Revisar sintaxis en el panel Acciones o en la ventana Script .
• Haga clic en el panel Script y, a continuación, presione Control+T (Windows) o Comando+T (Macintosh). Si hace clic o escribe en el panel Script le transferirá la selección. Si un objeto del escenario está seleccionado, se abre el panel Transformar en su lugar.

Los errores de sintaxis se muestran en el panel de errores del compilador.

Comprobración de emparejamiento de puntuación

(En desuso en Animate) Importación y exportación de scripts

Se puede importar un script al panel Acciones o a la ventana Script. De igual forma se pueden exportar los scripts desde el panel Acciones o desde archivos ActionScript externos. (Cuando esté utilizando la ventana Script, la exportación es innecesaria, ya que puede guardar el archivo AS.)

Si el texto de los scripts no tiene el aspecto esperado al abrir o al importar un archivo, cambie la preferencia de codificación de importación.

Importación de un archivo AS externo

Exportación de un script desde el panel Acciones

Establecimiento de las opciones de codificación del texto

Activación o desactivación del mensaje de advertencia de la codificación de exportación

(En desuso en Animate) Codificación de scripts importados y exportados

Puede definir en las preferencias de ActionScript el tipo de codificación que se debe utilizar al importar o exportar archivos de ActionScript. La codificación UTF-8 es el formato Unicode de 8 bits, que permite incluir texto en varios idiomas en el archivo; la Codificación predeterminada es la codificación admitida por el idioma del sistema, que utiliza también se denomina página de códigos tradicional.

Fijación de scripts en el panel Acciones

Utilice la función Fijar script para fijar fichas de scripts individuales en el panel Script y para moverlas como desee. Esta función es útil si no ha organizado el código del archivo FLA en una única ubicación central o si utiliza varios scripts.

También puede fijar un script para mantener la ubicación abierta del código en el panel Acciones y conmutar entre los distintos scripts abiertos. Esto puede resultar especialmente útil al depurar. 

También puede liberar un script o todos ellos desde el panel Acciones.

En la figura siguiente, el script asociado con la ubicación actual de la línea de tiempo se encuentra en el fotograma 1 de la capa llamada Simplificar. La ficha del extremo izquierdo siempre indica la ubicación a lo largo de la línea de tiempo. El script también se fija como se muestra en la ficha de la derecha. Se han fijado los dos scripts siguientes:

• En el fotograma 1 
• En el fotograma 15 de la capa llamada Intro

Utilice los métodos abreviados de teclado o haga clic en las fichas para desplazarse entre los scripts fijados. Desplazarse entre los distintos scripts fijados no cambia la posición actual en la línea de tiempo.Si se selecciona un script nuevo en el navegador de ActionScript, la selección se desplaza al primer fotograma, es decir, el fotograma 1.

Fijación de un script

Liberar todos los scripts

Métodos abreviados de teclado para scripts fijados

Cuando el punto de inserción está en el panel Script, utilice los siguientes métodos abreviados de teclado para trabajar con scripts fijados.

Inserción de rutas de destino

Muchas acciones que se crean en el script afectan a clips de película, botones y otras instancias de símbolos. En el código, puede incluir referencias a instancias de símbolos en una línea de tiempo mediante la inserción de una ruta de destino, es decir, la dirección de la instancia a la que quiere hacer referencia. Puede establecer una ruta de destino absoluta o relativa. Una ruta absoluta contiene la dirección completa de la instancia. Una ruta relativa sólo contiene la parte de la dirección que difiere de la dirección del propio script en el archivo FLA, y dejará de funcionar si el script se desplaza a otra ubicación.

Uso de sugerencias para el código

Al trabajar en el panel Acciones o en la ventana Script, el software puede detectar la acción que está introduciendo y mostrar una sugerencia para el código. Existen dos tipos de sugerencias sobre códigos: una sugerencia que contiene sintaxis completa de la acción y un menú emergente en el que se enumeran posibles elementos de ActionScript, como nombres de métodos o propiedades (lo que en ocasiones se denomina la funcionalidad de completar código).

Las sugerencias para el código están activadas de forma predeterminada. Al definir las preferencias, puede desactivar las sugerencias para el código o determinar la rapidez con la que aparecen. Aunque las sugerencias para el código estén desactivadas en las preferencias, puede mostrar de forma manual una sugerencia para un comando específico.

Activación de sugerencias para el código

Las sugerencias para el código se pueden activar de varias maneras.

Utilización de tipos estrictos para objetos

Cuando se utiliza ActionScript 2.0 y puede emplean tipos estrictos para una variable basada en una clase incorporada (como Button, Array, etc.), el panel Script muestra sugerencias de código para la variable. Por ejemplo, suponga que escribe las dos líneas de código siguientes:

Tan pronto como introduzca el punto (.), Animate muestra la lista de métodos y propiedades disponibles para objetos Array en el menú emergente, ya que escribió la variable como un conjunto.

Sufijos y sugerencias para el código

Si utiliza ActionScript 1.0 o desea visualizar las sugerencias para el código de los objetos que crea sin tipos de datos estrictos, debe añadir un sufijo especial al nombre de cada objeto cuando lo cree. Por ejemplo, el sufijo que activa las sugerencias para el código para la clase Camera es _cam. Suponga que escribe el código siguiente: var my_array = new Array(); var my_cam = Camera.get();

Si introduce my_cam seguido de un punto, aparecen las sugerencias de código para el objeto Camera.

Para los objetos que aparecen en el escenario, utilice el sufijo del cuadro de texto Nombre de instancia del inspector de propiedades. Por ejemplo, para ver las sugerencias para el código de objetos MovieClip, utilice el inspector de propiedades para asignar nombres de instancia con el sufijo _mc a todos los objetos MovieClip. Así, siempre que escriba el nombre de instancia seguido de un punto, se mostrarán las sugerencias para el código.

En la siguiente tabla se enumeran los sufijos que activan sugerencias para el código en ActionScript 2.0:

Comentarios y sugerencias para el código

También puede utilizar comentarios de ActionScript para especificar una clase de objeto para las sugerencias para el código. En el ejemplo siguiente, un comentario indica a ActionScript que la clase de la instancia theObject es Object y así sucesivamente.

Si especificara theMC seguido de un punto después de estos comentarios, aparecerían las sugerencias para el código que muestran la lista de métodos y propiedades de MovieClip. Si especificara theArray seguido de un punto después de estos comentarios, aparecerían las sugerencias para el código que muestran la lista de métodos y propiedades de MovieClip.

No obstante, Adobe recomienda que, en lugar de esta técnica, se utilicen tipos de datos estrictos o sufijos, ya que dichas técnicas activan automáticamente las sugerencias para el código y hacen que el código sea más comprensible.

Especificación de las preferencias para sugerencias de código automáticas

• En el panel Acciones o en la ventana Script, seleccione Edición > Preferencias (Windows) o Animate > Preferencias (Macintosh), haga clic en Editor de código en la lista Categoría y luego active o desactive Sugerencias de código.

(En desuso en Animate) Especificación de una demora en las sugerencias para el código

Utilización de sugerencias para el código con formato de información sobre herramientas

Utilización de sugerencias para el código con formato de menú

Visualización manual de una sugerencia para el código

Sugerencias de código para clases personalizadas

Cuando se crean clases personalizadas de ActionScript 3.0, Animate las analiza y determina los objetos, las propiedades y los métodos que contienen. Luego Animate puede proporcionar sugerencias de código cuando se escribe código que hace referencia a las clases personalizadas. La finalización de código de clases personalizadas es automática en cualquier clase que vincule a otro código con el comando import.

Las sugerencias de código permiten a los desarrolladores trabajar más rápido al no tener que recordar todos los objetos, métodos y propiedades utilizados por la clase. Los diseñadores pueden trabajar con clases que no han escrito ellos mismos porque no necesitan tener información de primera mano para poder trabajar con ellas.

Las sugerencias de código incluyen lo siguiente:

• Sugerencias de código para referencias de clases anidadas

  Cuando se escriben referencias anidadas, la ayuda de las sugerencias de código resulta muy útil.

• Sugerencia de código para “this”

  Cuando escribe “this” en un archivo de clase, las sugerencias de código son las de dicha clase.

• Sugerencia de código para “new+<espacio>”

  Al escribir “new+<espacio>”, Animate muestra una lista con las clases y los paquetes disponibles.

• Sugerencia de código para “import”

  Al escribir “import+<espacio>”, Animate muestra una lista con los paquetes integrados y los personalizados.

• Sugerencia de código para bibliotecas SWC

  Cuando se añade una biblioteca SWC a la ruta de biblioteca de la ruta de biblioteca externa, Animate activa las sugerencias de código para todas las clases incluidas en el archivo SWC.