A assistência de conteúdo ajuda o utilizador a inserir ou terminar um controlo ou função, ou a terminar uma linha de código num editor de texto estruturado. O posicionamento do cursor no ficheiro de origem fornece o contexto para a assistência de conteúdo, de modo a colocar a sua disposição sugestões para concluir.
A maioria dos editores de texto estruturados fornecem assistência de conteúdo.para consultar uma lista de editores com assistência de conteúdo, consulte Editores de texto estruturados para linguagens de marcações. Se procura informações quanto à possibilidade de obter assistência de conteúdo, consulte Obter assistência de conteúdo em editores de texto estruturados
As secções abaixo descrevem detalhes relativos à assistência de conteúdo HTML, a assistência de conteúdo JavaScript e a assistência de conteúdo JSP.
A linguagem HTML é flexível quanto ao facto de alguns elementos HTML permitirem a omissão opcional de controlos de fim, tais como P, DT, DD, LI, THEAD, TR, TD, TH, etc. Outros elementos HTML, cuja definição estipula a ausência de conteúdo, poderão exigir sempre a omissão do controlo de fim, tais como BR, HR, LINK, META, e IMG. Este flexibilidade faz com que a função de assistência de conteúdo disponível no editor da página de origem HTML se revele menos precisa do que seria, caso tivesse uma linguagem de marcações mais rigidamente restrita.
A assistência de conteúdo torna-se mais vantajosa sempre que o utilizador precisa de completar um nome de controlo, adicionar um par de nome-valor de atributo de um controlo de início, ou seleccionar a partir de uma lista enumerada de valores de atributos.
Apesar de a assistência de conteúdo apresentar apenas os nomes de atributos que ainda não foram especificados num controlo de início, não tem em conta as limitações gramaticais dos identificadores. Por exemplo, o elemento HEADde HTML admite apenas zero ou uma ocorrência de um controlo TITLE no seu conteúdo. Caso peça assistência num conteúdo HEAD que já contêm um controlo TITLE, a assistência de conteúdo continuará a apresentar TITLE na sua lista de sugestões.
Porém, se um atributo tiver, obrigatoriamente, de estar de acordo com o DTD/Esquema, esse atributo aparecerá no início da lista, com um círculo amarelo como identificador no seu ícone.
Caso o seu cursor esteja numa posição em que a assistência de conteúdo esteja disponível, uma lista em janela emergente de opções disponíveis será apresentada. A lista é baseada no contexto. Por exemplo, se utilizar a assistência de conteúdo directamente após um controlo de parágrafo de abertura (<p>) , o primeiro item da lista da assistência de conteúdo será o controlo </p>) do parágrafo final correspondente.
A lista da assistência de conteúdo apresenta todas os identificadores disponíveis para a posição do cursor actual, incluindo os modelos. A imagem abaixo apresenta a lista da assistência de conteúdo predefinida para um exemplo de controlo de parágrafo:
As sugestões de controlo são listadas alfabeticamente. Se o utilizador escrever < (para iniciar um novo controlo) antes de solicitar a assistência de conteúdo, e começar a escrever a primeira ou as duas primeiras letras do controlo que pretende adicionar, a lista de sugestões será automaticamente actualizada para reflectir as sugestões que correspondem ao padrão que escreveu. Se o utilizador não escrever < antes de solicitar a assistência de conteúdo, pode fazer clique na lista de sugestões e escrever, então, a letra com a qual começa o controlo, para reduzir (um pouco) a quantidade de deslocamento, com vista a localizar o controlo desejado.
À medida que escreve a primeira ou as duas primeiras letras dos nomes dos atributos ou dos valores dos atributos enumerados que pretende adicionar a um controlo, a lista é automaticamente actualizada, de modo a reflectir as sugestões que correspondem ao padrão que escreveu.
Os
itens da lista de assistência de conteúdo
JavaScript
são precedidos por um ícone da Internet Explorer, um ícone da Netscapem, ou ambos, para indicar se
os objectos, métodos ou funções
JavaScript
específicos são suportados por um ou por ambos os browsers. Caso o ícone da Internet Explorer
esteja presente, significa que o objecto, método ou função é suportado pela Versão 5.0 do Internet
Explorer ou por uma versão mais avançada. Caso o ícone da Netscape esteja presente,
significa que o objecto, método ou função é suportado pela Versão 4.7 do Netscape Navigator ou por
uma versão mais avançada. Um ícone de ponto de interrogação
) em vez de um dos ícones do browser indica que não
se sabe se o browser suporta o objecto, o método ou a função.
A imagem abaixo apresenta a lista de assistência de conteúdo predefinida de um ficheiro JavaScript:
As sugestões de código são listadas alfabeticamente. Caso escreva . (incluir o espaço) antes de solicitar assistência de conteúdo, começando a escrever a primeira ou as duas primeiras letras do código que pretende adicionar, a lista de sugestões é automaticamente actualizada para reflectir as sugestões que correspondem ao padrão que escreveu, de modo a reduzir (um pouco) a quantidade de deslocamento para localizar o código desejado.
Dispõe de muitas opções para incorporar o código HTML e Java nas suas páginas JSP, através da utilização da assistência de conteúdo.
Todas os identificadores JSP estão incluídos, quer na lista de modelos, quer em formato XML (por exemplo, <jsp:expression>).
para adicionar controlos de scriplet JSP, mova o cursor para a posição
adequada no ficheiro
e prima Ctrl+Barra de espaços para utilizar a assistência de conteúdo. Seleccione
a partir da lista de sugestões para inserir <%
%> no documento.
<% System.currentTimeMillis() %>
Este exemplo irá avaliar a instrução Java para obter o tempo actual em milissegundos.
<b>This is the time : <%= System.currentTimeMillis()%></b>
<jsp:useBean id="useBean" class="java.lang.String"/>
O controlo useBean permite ao utilizador criar um bean denominado por aString de tipo String. Assim, sempre que utiliza a assistência de conteúdo, esse bean é reconhecido como uma variável declarada. Por exemplo, caso utilize a assistência de conteúdo depois de aString, do seguinte modo:
<% aString. %>a lista da assistência de conteúdo apresenta os métodos disponíveis. Isto acontece uma vez que o bean aString foi declarado como um bean de tipo String.
<% a %>a assistência de conteúdo sabe que o bean aString existe, sendo apresentado na lista de assistência de conteúdo.