IntelliSense de JavaScript

Artigo
03/12/2013

Ajuda do IntelliSense você escreve o código mais rapidamente e com menos erros fornecendo informações quando você código.Enquanto você trabalha com script de cliente no editor do Javascript, o IntelliSense lista os objetos, funções, propriedades, e os parâmetros que estão disponíveis com base no contexto atual.Você pode selecionar um padrão de codificação de lista pop-up fornecida pelo IntelliSense para concluir o código.

O IntelliSense facilita complete as seguintes tarefas:

Informações de membros de localização.
Elementos de linguagem de inserção diretamente no seu código.
Mantenha seu contexto sem ter que deixar o editor de códigos.
Suporte IntelliSense personalizado com comentários de documentação XML e extensibilidade do IntelliSense Javascript.

Para obter informações sobre novos recursos de serviço linguístico Javascript, consulte Novidades no Visual Studio 2012.

Este tópico contém as seções a seguir:

Determinando o contexto do IntelliSense
Informações do IntelliSense de processamento
Recursos do IntelliSense Javascript
Extensibilidade de O Javascript
Validação de Javascript

Para obter mais informações sobre a funcionalidade do IntelliSense de Visual StudioUsando IntelliSense, consulte.

Determinando o contexto do IntelliSense

O Javascript IntelliSense fornece as opções de codificação base em qualquer script que são pertinentes ao contexto atual de script.Isso inclui os elementos de script no arquivo atual.Também inclui todo o código que é referenciado diretamente ou indiretamente do script, tais como referências de arquivo de script, referências a scripts do assembly, referencia serviço, e referências páginas associadas.

O contexto atual de script é criado com base nos seguintes itens:

As funções que são definidas em qualquer script apenas ativo no documento.Blocos internos de script são suportados em arquivos que têm as extensões de nome de arquivo .aspx., .ascx, .master, .html, e .htm.
elementos descript com atributos de src que apontam para outro arquivo de script.O arquivo de script de destino deve ter a extensão de nome de arquivo .js.
Os arquivos de Javascript que referenciam o outro arquivo Javascript usando uma diretiva de reference .
Grupos de referência para objetos globais, extensões do IntelliSense, ou arquivos de script atraso - carregados.
Referências Web services XML.
Os controles de ScriptManager e de ScriptManagerProxy , se o aplicativo da Web é um aplicativo ASP.NET AJAX.
Microsoft Ajax Library, se você estiver trabalhando em um aplicativo ASP.NET AJAX ativado.

Observação

O IntelliSense não há suporte para script que está em atributos do manipulador de eventos aos elementos HTML ou, que é definido em href atribui.

Observação
O IntelliSense não há suporte para script que está em atributos do manipulador de eventos aos elementos HTML ou, que é definido em href atribui.

Informações do IntelliSense de processamento

Para fornecer o Javascript IntelliSense, o serviço linguístico executa as seguintes operações:

Cria uma lista de arquivos dependentes de Javascript que são baseados em referências no documento ativo e, com base no script de auditoria recursivamente faz referência nos arquivos referenciados.
Percorre a lista e coleta informações de tipo e outros dados relevantes de cada arquivo.
Agrega os dados e passe-os para o serviço linguístico Javascript, que torna informações de tipo e os dados disponíveis para o IntelliSense.
Monitora alterações para os arquivos que podem afetar a lista do IntelliSense e atualiza a lista quando necessário.Scripts em armazenamentos remotos (tais como os referenciados usando HTTP) não são monitorado.

Recursos do IntelliSense Javascript

O Javascript IntelliSense suporte aos seguintes objetos:

Elementos de (DOM) do modelo de objeto de documento
Objetos intrínsecos
Variáveis definidas pelo usuário, funções, e objetos
Objetos definidos em arquivos externos usando referências como referências a scripts, diretivas de referência e grupos de referência.
Objetos especificados em Comentários de documentação XML, como parâmetros e campos.
Objetos descritas usando marcas padrões de comentário Javascript (/).Para obter mais informações, consulte Estendendo JavaScript IntelliSense.
Objetos suportados usando o mecanismo de Extensibilidade de O Javascript .Para obter mais informações, consulte Estendendo JavaScript IntelliSense.
Objetos AJAX ASP.NET

Quando o IntelliSense é não pode determinar o tipo de um objeto, fornece opções para conclusão da instrução usando identificadores no documento ativo.Para obter mais informações, consulte Conclusão da instrução para identificadores.

Elementos DOM HTML

O Javascript IntelliSense fornece referências de programação para elementos DOM HTML dinâmico (DHTML), como body, form, e div.Somente os elementos que estão incluídos na página do documento atual e mestra são exibidos pelo IntelliSense.O Javascript o IntelliSense também suporta os objetos de window e de document e seus membros.

Objetos intrínsecos

O Javascript IntelliSense fornece referências de programação para nativamente os objetos Array, String, Math, Date, e Numberintrínseco.Para obter mais informações sobre objetos intrínsecos Objetos intrínsecos (JavaScript), consulte.

Variáveis definidas pelo usuário, funções, e objetos

Quando você altera um arquivo Javascript, verifique Visual Studio documentos abertos e referenciados para determinar todos os recursos disponíveis em código.Isso inclui variáveis, funções, e objetos que você criou.Esses recursos estão disponíveis para Javascript no IntelliSense.

Para obter mais informações sobre as variáveis definidas pelo usuário, funções, e os objetos, consulte Criar seus próprios objetos no site do MSDN.

Referências de arquivo externo

Você pode incluir vários tipos de referências de arquivo externo para obter suporte IntelliSense no seu código.Referências de arquivo externo podem ser referências a scripts, diretivas de referência, ou podem ser especificados usando grupos de referência.

Referências a scripts

Em vez de escrever qualquer script de cliente em uma página, você pode referenciar os arquivos externos que incluem o código de script.Isso torna mais fácil para você reutilize o código entre páginas, e permite que o script de cliente para ser armazenado em cache pelo navegador.

Se você não estiver trabalhando com uma página da Web asp.net ajax-habilitada, você pode fazer referência a um arquivo de script externa usando o atributo de src na marca de abertura do elemento de script .O atributo de src especifica a URL em um arquivo externo que contém o código-fonte ou dados.

O exemplo a seguir mostra a marcação usando o atributo de src em uma marca <script> para fazer referência a um arquivo de script.

<script type="text/javascript" src="~/Scripts/JavaScript.js">
  
</script>

Se você estiver trabalhando com uma página da Web asp.net ajax-habilitada, você pode referenciar arquivos de script usando o objeto de ScriptReference de controle de ScriptManager .

O exemplo a seguir mostra a marcação que usa um objeto de ScriptReference em um controle de ScriptManager para fazer referência a um arquivo de script.

<asp:ScriptManager ID="ScriptManager1" runat="server">
  <Scripts>
    <asp:ScriptReference Path="~/Scripts/JavaScript.js" />
  </Scripts>
</asp:ScriptManager>

O IntelliSense também suporta os arquivos de script que são inseridos como recursos em um assembly em aplicativos Web ASP.NET AJAX.Para obter mais informações sobre recursos inseridos de script, consulte Embedding a JavaScript File as a Resource in an Assembly.

Diretivas referenciar

Uma política de reference permite que Visual Studio para estabelecer um relacionamento entre o script que você está atualmente editando e outro script.A política de reference permite que você inclua um arquivo de script no contexto do arquivo de script atual.Isso permite que o IntelliSense para referenciar externamente funções definidas, os tipos, e os campos quantos você codifica.

Você cria uma política de reference na forma de um comentário XML.A diretiva deve ser declarada anteriormente no arquivo de que qualquer script.Uma política de reference pode incluir uma referência de disco base de script, uma referência de script em conjuntos, uma referência serviço- base de script, ou uma referência a base de script.

Os exemplos a seguir mostra um exemplo de usar políticas rígido com base de referência.O primeiro exemplo, o serviço linguístico procurar o arquivo na mesma pasta que contém o arquivo de projeto (por exemplo, .jsproj).

/// <reference path="ScriptFile1.js" />

/// <reference path="Scripts/ScriptFile2.js" />

/// <reference path="../ScriptFile3.js" />

/// <reference path="~/Scripts/ScriptFile4.js" />

O exemplo a seguir mostra como criar uma referência a um script assembly com base.

/// <reference name "Ajax.js" assembly="System.Web.Extensions, ..." />

O exemplo a seguir mostra como fazer referência ao script serviço- base:

/// <reference path="MyService.asmx" />

/// <reference path="Services/MyService.asmx" />

/// <reference path="../MyService.asmx" />

/// <reference path="~/Services/MyService.asmx" />

Observação
O Javascript IntelliSense não há suporte para script que está contido em arquivos de serviço Web (.asmx) em projetos de aplicativo da Web (WAP).

O exemplo a seguir mostra como fazer referência ao script a página baseado.

/// <reference path="Default.aspx" />

/// <reference path="Admin/Default.aspx" />

/// <reference path="../Default.aspx" />

/// <reference path="~/Admin/Default.aspx" />

As seguintes regras se aplicam a reference uma diretiva.

O reference de comentário XML deve ser declarado antes de qualquer script.
Você deve usar a sintaxe de comentários XML com três barras.As referências feitas usando a sintaxe de comentários de duas barras padrão () são ignoradas.
Somente um arquivo ou recurso podem ser especificados pela diretiva.
Várias referências a scripts baseados que não são permitidas.
Se uma referência da página for especificada, nenhum outro tipo de diretivas de referência é permitido.
Caminhos relativos do uso de nomes de arquivo.Você pode usar o operador til (~) para fazer caminhos de aplicativo-raiz- relativo.
Caminhos absolutos são ignorados.
Diretivas de referência em páginas de referência não serão processar- que é, diretivas de referência não são resolvidas recursivamente para páginas.Somente o script que é referenciado diretamente pela página é incluído.

Grupos de referência

Você pode usar grupos de referência para especificar que os arquivos específicos do IntelliSense .js estão no escopo para todos os seus projetos Javascript.Três grupos de referência estão disponíveis: Grupos de trabalho implícitos (Windows), implícitos Web (), e dedicados de referência.As referências implícitas (Windows) são para aplicativos de Windows Store usando Javascript, e referências implícitas (Web) são para projetos HTML5.Os arquivos incluídos nesses grupos implícitos de referência estão no escopo para cada arquivo .js aberto no editor de códigos.

O grupo de trabalho dedicado de referência é para trabalhadores de HTML5 Web.Os arquivos especificados neste grupo estão no escopo para arquivos .js que tem uma referência explícita a um grupo de trabalho dedicado de referência.As referências implícitas não se aplicam a arquivos .js que tem uma referência explícita a um grupo de trabalho dedicado de referência.

Você pode usar opções de configuração para que o editor de código Javascript especifica referências implícitas.Para obter mais informações, consulte Opções, Editor de texto, JavaScript, IntelliSense.

Dica
Referências do IntelliSense geralmente são usadas para fornecer suporte IntelliSense para objetos globais e o IntelliSense para extensões.Você também pode usar esse recurso para os scripts que devem ser carregados em tempo de execução usando o carregador de script.

Comentários da Documentação XML

Comentários de documentação XML são descrições de texto que você adiciona ao script.Essas descrições de texto são exibidas em IntelliSense quando você referencia o script comentado.Por exemplo, você pode fornecer informações sobre parâmetros e valor de retorno de uma função.Comentários de documentação XML estão disponíveis somente arquivos, de assemblies, e serviços referenciados.Para obter mais informações, consulte Comentários de documentação XML (JavaScript) e Como: criar comentários da documentação XML do JavaScript.

O IntelliSense pode exibir referências de código para comentários XML nas seguintes situações: referência de arquivo

Um arquivo .js que faz referência a outro arquivo .js.
Um arquivo .js que referencia um arquivo .aspx.
Um arquivo .aspx que referencia um arquivo .js.

O IntelliSense não está disponível quando referências de um arquivo .aspx outro arquivo .aspx.

Objetos AJAX ASP.NET

ASP.NET AJAX também suporta o Javascript IntelliSense.ASP.NET AJAX inclui uma estrutura de cliente que estende os tipos padrão que estão disponíveis em ECMAScript (Javascript).Para ativar o IntelliSense Javascript para fornecer detalhes sobre objetos AJAX ASP.NET, os comentários de documentação XML foram adicionados em todo Microsoft Ajax Library.Esses comentários de documentação XML são exibidos quando você usa os tipos e membros que estão contidos na biblioteca AJAX do ASP.NET.

Observação
Os membros particulares não são exibidos pelo Javascript IntelliSense.Os membros particulares são denotados AJAX ASP.NET como os membros que começam com um sublinhado (_).

Extensibilidade de O Javascript

O serviço linguístico Javascript fornece os objetos e funções que permitem que você altere a experiência do IntelliSense para os desenvolvedores que usam bibliotecas de terceiros.Esses recursos são especialmente úteis quando o serviço linguístico de linguagem padrão não pode fornecer quaisquer informações que você deseja fornecer aos clientes.Para obter mais informações, consulte Estendendo JavaScript IntelliSense.

Validação de Javascript

Validação de script Javascript ocorre constantemente no plano de fundo.Quando Visual Studio detectar erros de sintaxe no código Javascript, comentários são fornecidos das seguintes maneiras:

Elementos sublinhados no editor.Os traços ondulados vermelho indica erros.Se você mantiver o ponteiro do mouse sobre o erro, uma dica de ferramenta exibe a descrição de erro.
a janela deLista de erros .A janela de Lista de erros exibe a descrição de erro, o arquivo onde o erro ocorreu, a linha e o número da coluna, e o projeto.Para exibir a janela de Lista de erros , no menu de Modo de Visualização , clique Lista de erros.
A janela de saída mostra as referências que não foram carregados.

De volta ao topo

Consulte também

Compartilhar via