L'assistente ai contenuti consente di inserire o completare un tag o funzione o di completare una riga di codice in un editor di testo strutturato. La posizione del cursore nel file di origine fornisce il contesto all'assistente ai contenuti per offrire suggerimenti per il completamento.
La maggior parte degli editor di testo strutturati è dotata di assistente ai contenuti. Per un elenco di editor con assistente ai contenuti, fare riferimento alla sezione Editor di testo strutturati per linguaggi di markup. Per ulteriori informazioni su come richiamare l'assistente ai contenuti, fare riferimento a Richiamo dell'assistente ai contenuti in editor di testo strutturati.
Nelle sezioni seguenti vengono descritti aspetti specifici di assistente ai contenuti HTML, JavaScript e JSP.
HTML è un linguaggio flessibile in cui alcuni elementi HTML consentono l'omissione di tag di fine, come ad esempio P, DT, DD, LI, THEAD, TR, TD, TH e così via. Altri elementi HTML definiti in modo da non avere un contenuto possono richiedere che la tag di fine venga sempre omessa, come BR, HR, LINK, META e IMG. Questa flessibilità rende la funzione di assistente ai contenuti all'interno dell'editor della pagine di origine HTML meno preciso di quanto sarebbe con un linguaggio di markup più rigido.
L'assistente ai contenuti HTML è utile quando è necessario completare il nome di una tag, aggiungere una coppia nome-valore di un attributo all'interno di una tag di inizio o selezionare da un elenco numerato di valori di attributi.
Nonostante l'assistente ai contenuti mostri solo nomi di attributi che non sono già stati specificati in una tag di inizio, esso non tiene in considerazione le limitazioni di sintassi nelle tag. Ad esempio, l'elemento HEAD in HTML consente solo zero o una ricorrenza di una tag TITLE nel contenuto. Se si richiede un assistente ai contenuti all'interno di un contenuto HEAD che contiene già una tag TITLE, l'assistente ai contenuti mostrerà comunque TITLE nell'elenco di proposte.
Tuttavia, se viene richiesto un attributo in base al DTD o allo schema, l'attributo verrà visualizzato all'inizio dell'elenco, con un cerchio giallo sull'icona.
Se il cursore si trova in una posizione in cui l'assistente ai contenuti è disponibile, viene visualizzato un elenco a comparsa di scelte disponibili. L'elenco si basa sul contesto. Ad esempio, se si utilizza l'assistente ai contenuti subito dopo una tag paragraph di apertura (<p>), il primo elemento nell'elenco di assistente ai contenuti sarà la corrispondente tag paragraph di chiusura (</p>).
Nell'elenco dell'assistente ai contenuti vengono visualizzate tutte le tag disponibili per la posizione corrente del cursore, inclusi i modelli. L'immagine riportata di seguito mostra l'elenco di assistente ai contenuti predefinito per una tag paragraph:
Le proposte di tag sono riportate in ordine alfabetico. Se si immette < (per iniziare una nuova tag) prima di richiedere l'assistente ai contenuti e si immettono le prime lettere della tag che si desidera aggiungere, l'elenco verrà aggiornato automaticamente in ordine alfabetico in modo da visualizzare l'immissione dell'utente. Se non si immette < prima di richiedere l'assistente ai contenuti, è possibile fare clic all'interno dell'elenco di proposte e immettere quindi la lettera con cui inizia la tag in modo da ridurre il numero di elementi da scorrere per arrivare alla tag desiderata.
Se si immettono le prime lettere dei nomi dell'attributo o dei valori dell'attributo numerato desiderato per aggiungere una tag, l'elenco verrà aggiornato automaticamente in modo da riflettere le proposte corrispondenti al modello immesso.
Gli elementi nell'elenco di assistente ai contenuti JavaScript sono preceduti da una icona di Internet Explorer o di Netscape (o di entrambe) a indicare se sono supportati determinati metodi o funzioni JavaScript con i browser. Se è presente l'icona di Internet Explorer, questa indica che l'oggetto, il metodo o la funzione è supportato da Internet
Explorer Versione 5.0 o superiore. Se è presente l'icona di Netscape, questa indica che l'oggetto, il metodo o la funzione è supportato da Netscape Navigator Versione
4.7 o superiore. Un'icona a forma di punto interrogativo () al posto di una delle icone del browser indica che è sconosciuto anche se il browser supporta l'oggetto, il metodo o la funzione.
La figura riportata di seguito mostra l'elenco predefinito di assistente ai contenuti all'interno di un file JavaScript:
Le proposte di codice sono riportate in ordine alfabetico. Se si immette un punto (. ), compreso lo spazio, prima di richiamare l'assistente ai contenuti e si immettono le prime lettere della code che si desidera aggiungere, l'elenco verrà aggiornato automaticamente in ordine alfabetico in modo da visualizzare l'immissione dell'utente.
Sono disponibili molte opzioni per l'integrazione del codice Java e HTML nelle pagine JSP mediante l'assistente ai contenuti.
Tutte le tag JSP
sono incluse sia nell'elenco di modelli che in formato XML (ad esempio, <jsp:expression>).
Per aggiungere tag di scriptlet JSP, ad esempio, spostare il cursore sulla posizione appropriata nel file e premere Ctrl+Barra spaziatrice per richiamare l'assistente ai contenuti. Selezionare dall'elenco di proposte per inserire <% %> nel documento.
<% System.currentTimeMillis() %>
In questo esempio viene valutata l'istruzione Java per richiamare l'ora corrente in millisecondi.
<b>This is the time : <%= System.currentTimeMillis()%></b>
<jsp:useBean id="useBean" class="java.lang.String"/>
La tag useBean consente di creare un bean denominato aString di tipo String. Quindi, quando si utilizza l'assistente ai contenuti, questa tag viene riconosciuta come una variabile dichiarata. Ad esempio, se si utilizza l'assistente ai contenuti dopo aString, come in
<% aString. %>l'elenco dell'assistente ai contenuti riporterà tutti i metodi disponibili. Ciò si verifica perché aString è stato dichiarato come bean di tipo String.
<% a %>l'assitente ai contenuti riconosce che aString esiste e viene pertanto visualizzato nell'elenco.