Assistente de Conteúdo

O assistente de conteúdo ajuda a inserir ou concluir uma tag ou função ou concluir uma linha de código em um editor de texto estruturado. O posicionamento do cursor no arquivo de origem fornece o contexto para que o assistente de conteúdo ofereça sugestões para conclusão.

A maioria dos editores de texto estruturado possuem assistente de conteúdo. Para obter uma lista de editores que possuem assistente de conteúdo, consulte Editores de Texto Estruturado para Linguagens de Marcações. Para obter informações sobre como obter a assistente de conteúdo, consulte Obtendo Assistência de Conteúdo em Editores de Texto Estruturado

As seções a seguir descrevem informações específicas do assistente de conteúdo HTML, assistente de conteúdo JavaScript™ e assistente de conteúdo JSP.

Assistente de Conteúdo HTML

O HTML é flexível, em que alguns elementos HTML permitem que tags de finalização sejam opcionalmente omitidas, como P, DT, DD, LI, THEAD, TR, TD, TH e etc. Outros elementos HTML definidos para não ter conteúdo podem requerer que a tag de finalização seja sempre omitida, como BR, HR, LINK, META e IMG. Essa flexibilidade torna a função do assistente de conteúdo no editor de página de origem HTML menos exata do que poderia ser com uma linguagem de marcações mais rigorosamente limitada.

O assistente de conteúdo HTML é mais vantajoso quando você precisa concluir um nome de tag, incluir um par nome-valor de atributo em uma tag de início ou selecionar valores de uma lista de atributos enumerados.

Embora o assistente de conteúdo mostre apenas nomes de atributos que ainda não foram especificados em uma tag de início, ele não considera restrições de gramática para tags. Por exemplo, o elemento HEAD em HTML permite apenas zero ou mais ocorrências de uma tag TITLE em seu conteúdo. Se você solicitar um assistente de conteúdo em um conteúdo HEAD que já contém uma tag TITLE, o assistente de conteúdo também mostrará TITLE em sua lista de propostas.

Entretanto, se um atributo for necessário de acordo com o DTD/Esquema, esse atributo será mostrado no início da lista, com um indicador de círculo amarelo em seu ícone.

Se o cursor estiver em uma posição na qual o assistente de conteúdo está disponível, uma lista pop-up de opções disponíveis será exibida. A lista baseia-se no contexto. Por exemplo, se você utilizar o assistente de conteúdo diretamente após uma tag de parágrafo de abertura (<p>), o primeiro item na lista do assistente de conteúdo será a tag de parágrafo de fechamento (</p>) correspondente.

A lista do assistente de conteúdo exibe todas as tags disponíveis para a posição atual do cursor, incluindo modelos. A figura a seguir mostra a lista de assistentes de conteúdo padrão para um exemplo de tag de parágrafo:
Assistente de conteúdo HTML

As propostas de tags são listadas em ordem alfabética. Se você digitar um < (para iniciar uma nova tag) antes de solicitar o assistente de conteúdo e começar a digitar a primeira letra ou as duas primeiras letras da tag que deseja incluir, a lista de propostas será atualizada automaticamente para refletir as propostas que correspondem ao padrão digitado. Se você não digitar um < antes de solicitar o assistente de conteúdo, poderá clicar na lista de propostas e, em seguida, digitar a letra com a qual a tag começa, para reduzir (um pouco) a quantidade de rolagem para localizar a tag desejada.

Conforme você digita a primeira letra ou as duas primeiras letras dos nomes de atributos ou valores de atributos enumerados que deseja incluir em uma tag, a lista é atualizada automaticamente para refletir as propostas que correspondem ao padrão digitado.

Restrição: Para Linux. Ao usar o Linux (Motif ou GTK) e um código de idioma DBCS, clicando duas vezes na lista de assistentes de conteúdo podem em algumas vezes fazer com que a VM Java™ finalize. Em vez de um clique duplo na lista, utilize as teclas de setas e Enter para fazer a seleção na lista.

Assistente de Conteúdo JSP

Você tem diversas opções para código Java e HTML integrado em suas páginas JSP usando o assistente de conteúdo.

Todas as tags JSP são incluídas na lista de modelos e no formato XML (por exemplo, <jsp:expressão>). Para incluir tags de scriptlet JSP, por exemplo, mova o cursor para a posição apropriada no arquivo e pressione Ctrl+Espaço para utilizar o assistente de conteúdo. Selecione Assistente de Conteúdo de Scriptlet JSP na lista de propostas para inserir <% %> no documento.

Os scriptlets são inseridos em uma tag <% %>. Exemplo:
<% System.currentTimeMillis() %>

Este exemplo avaliará a instrução Java para obter o horário atual em milissegundos.

Para que o resultado da instrução seja inserido no arquivo, coloque um sinal de igual (=) na frente da instrução. Exemplo:
<b>Esta é a hora: <%= System.currentTimeMillis()%></b>
Quando estiver dentro de um scriptlet, você estará compondo código Java puro. Assim, o assistente de conteúdo funciona exatamente como ele faria para o editor Java. Por exemplo, se você solicitar o assistente de conteúdo após System, o assistente de conteúdo exibirá uma lista de métodos.
Nota: O assistente de conteúdo Java funciona apenas em um projeto da web, porque ele exige um caminho de construção para localizar as classes Java adequadas.
Também existem tags especiais, como useBean. Exemplo:
<jsp:useBean id="useBean" class="java.lang.String"/>

A tag useBean permite criar um bean chamado aString do tipo Cadeia. Quando você utiliza, então, o assistente de conteúdo, isso é reconhecido como uma variável declarada. Por exemplo, se você utilizar o assistente de conteúdo após aString, conforme a seguir:

<% aString. %> 
a lista do assistente de conteúdo mostrará métodos disponíveis. Isso ocorre porque aString foi declarado como um bean do tipo Cadeia.
Se você utilizar o assistente de conteúdo após o a, conforme a seguir:
<% a %> 
o assistente de conteúdo saberá que aString existe e ele será mostrado na lista do assistente de conteúdo.
Conceitos Relacionados
Editores de texto estruturados para linguagens de marcações
Tarefas Relacionadas
Obtendo o assistente de conteúdo em editores de texto estruturados
Incluindo e removendo modelos HTML