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 une liste d'éditeurs disposant d'un assistant de contenu, voir Editeurs de texte structuré pour les langages de marquage. Pour plus d'information sur l'obtention de l'assistant de contenu, voir Obtention d'un assistant de contenu dans les éditeurs de texte structuré
La section ci-dessous décrit les caractéristiques des assistants de contenu HTML, JavaScript et JSP.
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 demandez une assistance dans un contenu HEAD qui contient déjà une balise TITLE, l'assistant de contenu affiche toujours TITLE dans sa liste de propositions.
Toutefois, si un attribut est nécessaire en fonction du DTD/du schéma, l'attribut apparaît en haut de la liste entouré d'un cercle jaune dans son icône.
Si votre curseur se trouve à un endroit pour lequel l'assistant de contenu est disponible, une liste contextuelle reprenant les options disponibles s'affiche. La liste repose sur le contexte. Si, par exemple, 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 correspond à la balise de fermeture de paragraphe associée (</p>).
La liste de l'assistant de contenu contient toutes les balises disponibles à l'emplacement en cours du curseur, y compris les modèles. La figure ci-dessous montre la liste de l'assistant de contenu par défaut pour
un exemple de balise de paragraphe :
Les propositions de balises sont classées par ordre alphabétique. Si vous tapez < (pour commencer une nouvelle balise) avant de demander l'assistance de contenu, et que vous tapez la première lettre ou les deux premières lettres de la balise à ajouter, la liste des propositions est régénérée automatiquement pour refléter les propositions qui correspondent à ce que vous avez tapé. Si vous ne tapez pas < avant de demander l'assistance de contenu, vous pouvez cliquer sur la liste des propositions, puis taper la première lettre de la balise pour réduire (quelque peu) le défilement pour rechercher la balise appropriée.
Lorsque vous tapez la première lettre ou les deux premières lettres des noms d'attribut ou des valeurs d'attribut énumérées à ajouter à une balise, la liste est régénérée automatiquement pour refléter les propositions qui correspondent à ce que vous avez tapé.
Lorsque vous utilisez Linux (Motif
ou GTK) et un environnement local DBCS, cliquez deux fois avec le bouton droit de la souris sur la liste de l'assistant de contenu peut parfois entraîner l'arrêt de la machine virtuelle Java. Au lieu de cliquer deux fois sur la liste, utilisez les touches fléchées et la touche Entrée pour effectuer la sélection dans la liste.Vous disposez d'un grand nombre d'options pour incorporer du code Java et HTML dans vos 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 va évaluer l'instruction Java pour obtenir l'heure actuelle en millisecondes.
<b>C'est l'heure : <%= System.currentTimeMillis()%></b>
<jsp:useBean id="useBean" class="java.lang.String"/>
La balise useBean permet de créer un bean appelé aString de type chaîne. Ensuite, lorsque vous utilisez l'assistant de contenu, le bean est identifié comme variable déclarée. Par exemple, si vous utilisez l'assistant de contenu après aString, comme suit :
<% aString. %>, l'assistant de contenu affiche les méthodes disponibles du fait que aString a été déclaré sous la forme d'un bean de type chaîne.
<% a %>, l'assistant de contenu sait que aString existe, et il apparaît dans la liste de l'assistant.