L'assistant de contenu permet d'insérer ou de terminer une balise ou une fonction, ou de terminer une ligne de texte dans un éditeur de texte structuré. L'emplacement du curseur dans le fichier source fournit le contexte de l'assistant de contenu pour proposer des suggestions.
La plupart des éditeurs de texte structuré disposent d'un assistant de contenu. Pour la liste des éditeurs proposant un assistant de contenu, voir Edition du code source. Pour des informations sur la configuration de l'assistant de contenu, voir Configuration des préférences de l'éditeur de texte structuré.
HTML est un langage souple dans la mesure où les éléments HTML permettent d'omettre les balises de fin, telles que P, DT, DD, LI, THEAD, TR, TD, TH, etc. Les autres éléments HTML définis pour n'avoir aucun contenu peuvent nécessiter de toujours omettre la balise de fin, telle que BR, HR, LINK, META, et IMG. Du fait de cette souplesse, l'assistant de contenu dans l'éditeur de page source HTML s'avère moins précis qu'avec un langage de marquage plus strict.
L'assistant de contenu HTML est particulièrement utile lorsque vous devez terminer un nom de balise, ajouter une paire nom d'attribut-valeur dans une balise de début, ou sélectionner des valeurs dans une liste énumérée de valeurs d'attributs.
Bien que l'assistant de contenu affiche uniquement les noms des attributs qui ne sont pas encore définis dans une balise de début, il ne tient pas compte des règles grammaticales des balises. Par exemple, l'élément HEAD dans HTML autorise uniquement aucune ou une seule occurrence de la balise TITLE dans son contenu. Si vous appelez l'assistant de contenu dans un contenu HEAD qui contient déjà une balise TITLE, l'assistant de contenu affiche toujours TITLE dans sa liste de propositions ; toutefois, TITLE n'est pas mis en évidence dans la liste.
Cependant, si un attribut est nécessaire en fonction du DTD/du schéma, il apparaît dans la liste et son icône comporte un cercle jaune.
Si votre curseur se trouve à une position à laquelle l'assistant de contenu est disponible, la liste des options disponibles s'affiche. La liste repose sur le contexte. Par exemple, si vous utilisez l'assistant de contenu directement après une balise d'ouverture de paragraphe, <p>, le premier élément dans la liste de l'assistant de contenu est la balise de fermeture de paragraphe correspondante (</p>).
La liste de l'assistant de contenu contient toutes les balises disponibles à l'emplacement en cours du curseur, y compris les modèles. L'image ci-dessous représente la liste par défaut de l'assistant de contenu pour une balise de paragraphe :
Les propositions de balises sont classées par ordre alphabétique. Si vous entrez < pour commencer une nouvelle balise avant d'appeler l'assistant de contenu, entrez les premières lettres de la balise : la liste de propositions est actualisée automatiquement pour refléter les propositions qui correspondent à votre pattern. Si vous n'entrez pas < avant d'appeler l'assistant de contenu, vous pouvez cliquer dans la liste de propositions, puis entrer la première lettre de la balise afin de réduire le défilement.
Lorsque vous tapez les premières lettres des noms d'attribut ou des valeurs d'attribut énumérées à ajouter à une balise, la liste est actualisée automatiquement pour refléter les propositions qui correspondent à votre pattern.
Les propositions de code sont classées par ordre alphabétique. Si vous entrez un point suivi d'un espace avant d'appeler l'assistant de contenu et commencez à entrer les premières lettres du code, la liste de propositions est actualisée automatiquement pour refléter les propositions qui correspondent à votre pattern afin de réduire le défilement.
Vous disposez d'un grand nombre d'options pour incorporer du code Java et HTML dans les pages JSP en utilisant l'assistant de contenu.
Toutes les balises JSP
sont incluses dans la liste des modèles et dans le format XML (par exemple, <jsp:expression>). Pour ajouter des balises de scriptlet JSP, par exemple, amenez le curseur dans l'emplacement approprié dans le fichier et appuyez sur Ctrl+Barre d'espacement pour utiliser l'assistant de contenu. Sélectionnez dans la liste des propositions pour insérer <% %> dans le document.
<% System.currentTimeMillis(); %>
Cet exemple évalue l'instruction Java pour obtenir l'heure en cours en millisecondes.
<b>This is the time : <%= System.currentTimeMillis(); %></b>
<jsp:useBean id="useBean" class="java.lang.String"/>
Avec la balise useBean, vous pouvez créer un bean aString de type String. Lorsque vous utilisez l'assistant de contenu, ce bean est reconnu comme variable déclarée. Par exemple, si vous utilisez l'assistant de contenu après <% aString. %>, la liste de l'assistant de contenu répertorie les méthodes disponibles car aString est déclaré en tant que bean de type String.
Si vous utilisez l'assistant de contenu après <% a %>, l'assistant de contenu sait que aString existe et l'affiche dans sa liste.