Apresentação do ActionScript

A linguagem ActionScript® permite que você incorpore ao seu aplicativo maior complexidade de interação, controle de reprodução e exibição de dados. Você pode adicionar o ActionScript no ambiente de autoria, usando o painel Ações, a janela Script ou um editor externo.

O ActionScript segue suas próprias regras de sintaxe e de palavras-chave reservadas, e permite que você use variáveis para armazenar e recuperar informações. O ActionScript inclui uma vasta biblioteca de classes internas que permitem criar objetos para executar muitas tarefas úteis. Para obter mais informações sobre o ActionScript, consulte os seguintes tópicos de Ajuda:

Você não precisa compreender cada elemento do ActionScript para começar a criar scripts. Se você tiver um objetivo claro, poderá começar criando scripts com ações simples.

O ActionScript e o JavaScript estão fundamentados no padrão ECMA-262, o padrão internacional para a linguagem de scripts ECMAScript. Por essa razão, os desenvolvedores que estão familiarizados com o JavaScript se verão automaticamente familiarizados com o ActionScript. Para obter mais informações sobre o ECMAScript, acesse o site ecma-international.org.

Adobe recomenda...

Adobe recomenda...

Qual versão do ActionScript você pode usar?

O Animate inclui mais de uma versão do ActionScript para atender às necessidades de diferentes tipos de desenvolvedores e hardware de reprodução. ActionScript 3.0 e 2.0 não são compatíveis entre si.

 

  • O ActionScript 3.0 é executado de modo rápido. Essa versão requer uma familiaridade um pouco maior com os conceitos de programação orientada a objetos do que as outras versões do ActionScript. O ActionScript 3.0 é totalmente compatível com a especificação ECMAScript e oferece um melhor processamento de XML, um modelo de eventos aperfeiçoado e uma arquitetura aprimorada para trabalhos com elementos de tela. Os arquivos FLA que usam o ActionScript 3.0 não podem incluir versões anteriores do ActionScript.

  • (Descontinuado apenas no Animate CC) O ActionScript 2.0 é mais simples de aprender do que o ActionScript 3.0. Embora o Flash Player execute o código compilado da versão 2.0 mais lentamente do que o código compilado da versão 3.0, o ActionScript 2.0 ainda é útil para vários tipos de projetos. ActionScript 2.0 também é útil para projetos que não demandam muito computacionalmente. Por exemplo, conteúdo mais orientado ao design. O ActionScript 2.0 também é baseado na especificação ECMAScript, mas não é totalmente compatível.

  • (Descontinuado no Animate CC) O ActionScript 1.0 é a forma mais simples do ActionScript e ainda é usado por algumas versões do Flash Lite Player. O ActionScript 1.0 e o 2.0 podem coexistir no mesmo arquivo FLA.

  • (Descontinuado no Animate CC) O ActionScript do Flash Lite 2.x é um subconjunto do ActionScript 2.0 que é compatível com o Flash Lite 2.x executado em telefones e dispositivos móveis.

  • (Descontinuado no Animate CC) O ActionScript do Flash Lite 1.x é um subconjunto do ActionScript 1.0 que é compatível com o Flash Lite 1.x executado em telefones e dispositivos móveis.

 

Uso da documentação do ActionScript

Como há várias versões do ActionScript (2.0 e 3.0), e várias maneiras de incorporá-lo em seus arquivos FLA, existem vários modos diferentes de aprender a usar o ActionScript.

Você pode localizar a descrição sobre a interface gráfica do usuário para trabalhar com o ActionScript. A interface inclui o painel Ações, a janela Script, o modo Assistência de script, o painel Comportamentos, o painel Saída e o painel Erros do compilador. Os tópicos se aplicam a todas as versões do ActionScript.

Outras documentações do ActionScript da Adobe ajudarão você a saber mais sobre as versões individuais do ActionScript.

Modos de trabalhar com o ActionScript

Há vários modos de trabalhar com o ActionScript.

  • (Descontinuado após o Animate CC) O modo Assistência de script permite que você adicione o ActionScript em seu arquivo FLA sem que você mesmo tenha de escrever o código. Você seleciona ações e o software apresenta uma interface do usuário para especificação dos parâmetros necessários a cada ação. Saiba mais sobre quais funções você deve usar para executar tarefas específicas; não será necessário aprender a sintaxe. Muitos designers e não programadores usam este modo.

  • (Descontinuado após o Animate CC) Comportamentos também permitem que você adicione códigos em seu arquivo sem que você mesmo tenha de escrever o código. Os comportamentos são scripts pré-gravados de tarefas comuns. Você pode adicionar um comportamento e, depois, configurá-lo facilmente no painel Comportamentos. Os comportamentos só estão disponíveis no ActionScript 2.0 e anteriores.

  • Escrever o seu próprio ActionScript proporciona a você o maior grau de flexibilidade e controle sobre seu documento, mas requer que você se familiarize com a linguagem e as convenções do ActionScript.

  • Os componentes são clipes de filme pré-criados que o ajudam a implementar funcionalidade complexa. Um componente pode ser um simples controle da interface do usuário, como uma caixa de seleção, ou um controle complexo, como uma painel de rolagem. Você pode personalizar a funcionalidade e a aparência de um componente e pode fazer download de componentes criados por outros desenvolvedores. A maioria dos componentes exige que você escreva algum código ActionScript próprio para disparar ou controlar um componente. Para obter mais informações, consulte Uso dos componentes do ActionScript 3.0.

 

Programação de ActionScript

Ao programar código ActionScript no ambiente de autoria, você usa o painel Ações ou a janela Script. O painel Ações e a janela Script contêm um editor de código com recursos completos que incluem referências e atribuições de cores a código, formatação de código, destaque de sintaxe. Também contém depuração, números de linha, quebra de texto e o suporte a Unicode.

  • Use o painel Ações para escrever scripts que fazem parte de seu documento Animate (ou seja, scripts que estão incorporados no arquivo FLA). O painel Ações fornece recursos como a caixa de ferramentas Ações, que proporciona um rápido acesso aos elementos centrais da linguagem do ActionScript. Você obtém prompts para os elementos que exigem a criação de scripts.

  • Use a janela Script se você quiser escrever scripts externos, ou seja, scripts ou classes que são armazenados em arquivos externos. (Você também pode usar um editor de texto para criar um arquivo AS externo.) A janela Script inclui recursos de assistência de código como referências e atribuição de cores a código, verificação de sintaxe e formatação automática.

Mais conteúdo recomendado da comunidade

Os artigos e tutoriais a seguir apresentam mais informações detalhadas sobre o trabalho com o ActionScript:

Visão geral do painel Saída

Ao testar qualquer tipo de documento, o painel Saída exibe informações ou aviso relativo a operações, como conversões de documento e publicação. Para exibir essas informações, adicione instruções trace() a seu código ou use os comandos Listar objetos e Listar variáveis.

Se você usa a instrução trace() em seus scripts, é possível enviar informações específicas para o painel Saída, conforme o arquivo SWF é executado. Isto pode incluir observações sobre o status do arquivo SWF ou o valor de uma expressão. 

Output_panel
Painel Saída

O painel Saída consiste nos seguintes itens de menu:

  • Copiar: copia todo o conteúdo do painel Saída para a área de transferência do computador. Para copiar uma porção selecionada da saída, selecione a área que deseja copiar e, depois, selecione Copiar.
  • Limpar: limpa o conteúdo do painel Saída.
  • Mostrar saída: exibe o conteúdo do painel Saída.
  • Bloquear: bloqueia o painel. É possível apenas redimensionar o painel, mas não movê-lo ou arrastá-lo. 
  • Ajuda: carrega a ajuda online para o painel Saída.
  • Fechar: fecha o painel Saída.
  • Fechar grupo: fecha todo o grupo de painéis. Você pode encaixar simultaneamente os vários painéis, como linha do tempo, painel de saída e o painel de erros no compilador.

Para exibir ou ocultar o painel de saída, selecione Janela > Saída ou pressione F2.

Painel Ações

Procurando pela Referência de Linguagem?

Para encontrar a documentação de referência de um elemento de linguagem específico do ActionScript, siga um destes procedimentos:

Observação:

Para abrir Ajuda em um navegador em vez do aplicativo Community Help, consulte este artigo: http://kb2.adobe.com/community/publishing/916/cpsid_91609.html

Aprendendo o ActionScript

Para saber mais sobre como programar código ActionScript, use estes recursos:

Observação:

ActionScript 3.0 e 2.0 não são compatíveis entre si. Escolha somente uma versão para cada arquivo FLA criado.

Visão geral do painel Ações

Para criar scripts incorporados em um arquivo FLA, informe o ActionScript diretamente no painel Ações (Janela > Ações ou pressione F9).

actions-frame-view
Painel Ações

O painel Ações é composto por dois painéis:

Painel Script

Permite que você digite o código do ActionScript, que está associado ao quadro atualmente selecionado.

Navegador de scripts

Lista os scripts no seu documento do Animate e permite movimentação rápida entre eles. Para visualizar o script no painel Script, clique em um item no navegador de Scripts.

O Painel de ações permite que você acesse os recursos de assistência por código, que ajudam a simplificar a codificação no ActionScript. É possível adicionar scripts globais e de terceiros sem quadros que podem ser aplicados em toda a animação no Animate. Para obter mais informações, consulte a seção Adição de scripts globais e de terceiros nesta página. 

  • Executar script: executa o script
  • Fixar script: fixa o script nas guias de fixação dos scripts individuais no painel Script para movê-lo conforme necessário. Esse recurso é útil se você não tiver organizado o código em seu arquivo FLA em um local central, ou estiver usando vários scripts. Você pode fixar um script para manter o local do código no painel Ações e alternar entre vários scripts abertos. Esse recurso pode ser útil em depurações.
  • Inserir nome e caminho da ocorrência: ajuda a configurar o caminho de destino absoluto ou relativo para uma ação no script.
  • Localizar: localiza e substitui textos no script.
  • Formatar código: ajuda para formatar o código.
  • Snippets de código: abre o painel Snippets de código, que exibe amostras de snippets de código.
  • Adicionar usando o assistente: clique nesse botão para adicionar ações usando um assistente fácil de usar, sem ter que escrever código. 
  • Ajuda: exibe as informações de referência para o elemento do ActionScript que está selecionado no painel Script. Por exemplo, se você clicar em uma instrução import e, em seguida, clicar em Ajuda, as informações de referência para import serão exibidas no painel Ajuda.

Usar o assistente de códigos para ações

É possível adicionar interatividade a composições HTML5 com as opções Adicionar usando o assistente no painel Ações. Adicionar usando o assistente é uma interface de usuário simplificada para acrescentar códigos às suas composições.

Um vídeo que descreve como adicionar o código usando o assistente de códigos de ações

  1. Crie um novo documento HTML5 Canvas e clique em Janela > Ações.

  2. Clique em Adicionar usando o assistente no painel Ações, como mostrado no instantâneo a seguir. 

    addusingwizard-button
    Painel Ações com o botão Adicionar usando o assistente
  3. Selecione uma ação para a qual deseja criar um código usando o assistente de código.

    Um exemplo de captura de tela mostrando as opções do assistente de código de ação para ações

    No instantâneo acima, a ação Obter número do quadro está selecionada e o código correspondente foi atualizado na janela de ações.

    Com base no tipo de ação selecionado, você também pode escolher o objeto correspondente para o qual deseja aplicar a ação. É possível pesquisar por objetos específicos no palco se o objeto tiver um nome de ocorrência. Além disso, é possível aplicar a ação na seleção atual. 

    actions-code-currentselection
    Lista de objetos para aplicar a ação
  4. Clique em Próximo para escolher um evento de acionamento. Um conjunto de eventos de acionamento é listado na janela com base no tipo de ação e no tipo de objeto selecionados nas etapas anteriores. 

    action-trigger
    Lista de eventos de acionamento
  5. Escolha um evento de acionamento apropriado seguido por seus objetos de acionamento correspondentes, se houver, e clique no botão Concluir e adicionar

É possível escolher a opção Seleção atual no menu ao selecionar o objeto no palco e executar o assistente de códigos de ações. Também é possível escolher a linha do tempo e as ações de componentes para o código.

Usar a janela de script

A janela Script permite criar arquivos externos de script, que podem ser importados para seu aplicativo. Esses scripts podem ser arquivos do ActionScript ou do Animate JavaScript.

Você também pode adicionar scripts globais e de terceiros em documentos do HTML5 Canvas. Para obter mais informações, consulte a seção Adição de scripts globais e de terceiros em Criar e publicar documentos HTML5 Canvas no Animate CC

actions-add-script
Janela Script

Se você tem mais de um arquivo externo aberto, os nomes de arquivos são exibidos em guias no topo da janela Script.

Na janela Script, é possível usar PinScript, localizar e substituir, cor de sintaxe, código de formato, referências de código, comentários e recursos de recolhimento de código. Você também pode usar as opções de depuração (apenas para arquivos do ActionScript) e quebra de linha. A janela Script também permite a exibição de números de linha e de caracteres ocultos.

Criar um arquivo externo na janela Script

  1. Selecione Arquivo > Novo.

    Novo documento
    Novo documento
  2. Selecione o propósito desejado nas guias da parte superior da tela, como Animação de personagem, Social, Jogos, Ensino, Anúncios, Web e Avançado. Selecione o tipo do arquivo externo que você deseja criar (arquivos ActionScript ou Animate JavaScript).

Editar um arquivo existente na janela Script

  • Para abrir um script existente, selecione Arquivo > Abrir e, depois, abra um arquivo AS existente.

  • Para editar um script que já esteja aberto, clique a guia do documento que exibe o nome do script.

Ferramentas no painel Ações e na janela Script

O painel Ações permite que você acesse os recursos de assistência de código que ajudam a simplificar e dinamizar a codificação no ActionScript.

Localizar 

Localiza e substitui texto no script.

 

Inserir caminho de destino 

(Somente painel Ações) Ajuda na configuração do caminho de destino absoluto ou relativo para uma ação no script.

 

Ajuda 

Exibe as informações de referência para o elemento do ActionScript que está selecionado no painel Script. Por exemplo, se você clicar em um instrução import e, em seguida, clicar em Ajuda, as informações de referência para import aparecem no painel Ajuda.

 

Snippets de código

Abre o painel Snippets de código que exibe amostras de snippets de código.

 

Usar assistente

Ajuda a adicionar o código para ações usando uma interface sem precisar escrever código. 

Acessar a Ajuda sensível ao contexto do painel Ações

  1. Para selecionar um item de referência, realize um dos seguintes procedimentos:
    • Selecione um termo ActionScript no painel da caixa de ferramentas do painel Ações (à esquerda do painel Ações).

    • Selecione um termo ActionScript no painel Ações no painel Script.

    • Coloque o ponto de inserção antes do termo ActionScript no painel Ações no painel Script.

  2. Para abrir a página de referência do painel de Ajuda do item selecionado, realize um dos seguintes procedimentos:
    • Pressione F1.

    • Clique com o botão direito no item e selecione Exibir Ajuda.

    • Clique em Ajuda sobre o painel Script.

Definir preferências do ActionScript

Quer você edite o código no painel Ações ou na janela Script, você pode definir e modificar um único conjunto de preferências.

  1. Selecione Editar > Preferências (Windows) ou Animate > Preferências (Macintosh) e, depois, clique em Editor de código na lista Categoria.

  2. Defina as preferências desejadas:

    Recuo automático

    Quando o recuo automático está ativado, o texto digitado após um parêntese de abertura “(“ é automaticamente recuado de acordo com a configuração do Tamanho da tabulação. Esse comportamento também é aplicável ao usar o colchete de abertura “(“.

    Tamanho da tabulação

    Especifica o número de caracteres que uma linha é recuada.

    Referências de código

    Ativa a referência de código no painel Script.

    Atraso

    Especifica o atraso (em segundos) antes que as referências de código sejam exibidas. A opção foi descontinuada no Animate CC.

    Fonte

    Especifica a fonte usada em seu script.

    Abrir/importar

    Especifica a codificação de caractere usada quando você abre ou importa arquivos do ActionScript.

    Salvar/exportar

    Especifica a codificação de caractere usada quando você salva ou exporta arquivos do ActionScript.

    Recarregar arquivos modificados

    Especifica o que acontece quando um arquivo de script é modificado, movido ou excluído. Selecione Sempre, Nunca ou Solicitar.

    Sempre

    Nenhum aviso é exibido, e o arquivo é automaticamente recarregado.

    Nunca

    Nenhum aviso é exibido, e o arquivo permanece no estado atual.

    Solicitar

    (Padrão) É exibido um aviso, e você pode optar por recarregar o arquivo.

    Quando você cria aplicativos com scripts externos, essa preferência permite evitar a substituição de um script. Ou evite publicar o aplicativo com versões mais antigas dos scripts. Os avisos permitem que você feche automaticamente um script e reabra a versão modificada mais recente.

    Cores de sintaxe

    Especifica a atribuição de cores a códigos em seus scripts.

    Configurações do ActionScript 3.0

    Esses botões abrem as caixas de diálogo Configurações do ActionScript, onde você pode definir um caminho de origem, caminho de biblioteca e caminho de biblioteca externa para o ActionScript 3.0.

Esta obra está licenciada sob uma licença não adaptada da Creative Commons Attribution-Noncommercial-Share Alike 3.0  As publicações do Twitter™ e do Facebook não são cobertas pelos termos do Creative Commons.

Avisos legais   |   Política de privacidade online