Assistant de contenu

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é.

Les sections suivantes décrivent les caractéristiques des assistants :
Assistant de contenu HTML
Assistant de contenu JavaScript
Assistant de contenu JSP

Assistant de contenu HTML

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 :

Assistant de contenu HTML

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.

Restriction : Pour Linux. Lorsque vous utilisez Linux (Motif ou GTK) et un environnement local DBCS et si vous cliquez deux fois dans la liste de l'assistant de contenu, il se peut parfois que la machine virtuelle Java™ s'arrête. Au lieu de cliquer deux fois dans la liste, utilisez les flèches et la touche Entrée pour effectuer une sélection dans la liste.

Assistant de contenu JavaScript

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.

Assistant de contenu JSP

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 Assistant de contenu de scriptlet JSP dans la liste des propositions pour insérer <% %> dans le document.

Les scriptlets sont insérés dans une balise <% %>. Par exemple :
<% System.currentTimeMillis(); %>

Cet exemple évalue l'instruction Java pour obtenir l'heure en cours en millisecondes.

Pour insérer le résultat de l'instruction dans le fichier, placez un signe égal (=) devant l'instruction. Par exemple :
<b>This is the time : <%= System.currentTimeMillis(); %></b>
Dans un scriptlet, vous écrivez du code Java pur. Par conséquent, l'assistant de contenu fonctionne de la même manière qu'avec l'éditeur Java. Par exemple, si vous appelez l'assistant de contenu après System, l'assistant de contenu affiche une liste de méthodes.
Remarque : L'assistant de contenu Java ne peut fonctionner que dans un projet Web car il nécessite un chemin de génération pour rechercher les classes Java appropriées.
Il existe également des balises spéciales telles que useBean. Par exemple :
<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.

Icône indiquant le type de rubrique Rubrique
Dispositions pour les centres de documentation | Commentaires en retour

Icône d'horodatage Dernière mise à jour: May 29, 2014 10:11

Nom de fichier : csrcedt006.html