Contenthulp

Contenthulp biedt hulp bij het invoegen en afsluiten van een tag of functie en het afsluiten van een regel code in een editor voor gestructureerde tekst. De plaats van de cursor in het bronbestand bepaalt de context aan de hand waarvan contenthulp suggesties aanbiedt.

De meeste editors voor gestructureerde tekst beschikken over contenthulp. Een lijst van editors met contenthulp kunt u vinden in Editors voor gestructureerde tekst voor markuptalen. Informatie over het opvragen van contenthulp vindt u in Contenthulp opvragen in editors voor gestructureerde tekst

Hieronder wordt de werking beschreven van de HTML-contenthulp, de JavaScript™-contenthulp en de JSP-contenthulp.

HTML-contenthulp

U kunt de eindtags van sommige HTML-elementen weglaten, zoals P, DT, DD, LI, THEAD, TR, TD en TH. Bij andere HTML-elementen, die geen content hebben, moet u de eindtag altijd weglaten. Bijvoorbeeld: BR, HR, LINK, META en IMG. Door deze flexibiliteit is de HTML-contenthulp minder exact dan bij een markuptaal met striktere regels.

U hebt het meeste aan HTML-contenthulp als u een tag wilt afsluiten, als u een naam-waardepaar voor een kenmerk aan een starttag wilt toevoegen of als u een kenmerkwaarde uit een lijst wilt kiezen.

Contenthulp beeldt kenmerken af waarvan de starttag nog niet is gebruikt, maar houdt geen rekening met grammaticale beperkingen voor tags. Voorbeeld: het element HEAD in HTML staat in de content maximaal één TITLE-tag toe. Als u in de content van HEAD waarin al een TITLE-tag aanwezig is, vraagt om contenthulp, wordt TITLE toch afgebeeld in de lijst van tags.

Wanneer een kenmerk vereist is volgens het DTD/Schema, staat het kenmerk boven aan de lijst, met een gele cirkel rond het pictogram.

Wanneer de cursor zich op een positie bevindt waar contenthulp beschikbaar is, wordt een voorgrondlijst met suggesties afgebeeld. De lijst is gebaseerd op de context. Als u contenthulp bijvoorbeeld direct na een tag voor het openen van een paragraaf (<p>) gebruikt, is de bijbehorende sluittag voor een paragraaf (</p>) het eerste item in de lijst van contenthulp.

De lijst van contenthulp bevat alle beschikbare tags voor de cursorpositie, met inbegrip van sjablonen. In de onderstaande afbeelding ziet u de standaardlijst van contenthulp voor een paragraaftag:
HTML-contenthulp

De voorgestelde tags zijn alfabetisch gerangschikt. Wanneer u een < typt (voor een nieuwe tag), gevolgd door de eerste één of twee letters van de tag die u wilt toevoegen, wordt de lijst van contenthulp automatisch aangepast. Wanneer u geen < typt voordat u om contenthulp vraagt, kunt u in de lijst van voorgestelde tags klikken en de eerste letter van de gezochte tag typen. De lijst bladert dan in de richting van de gezochte tag.

Als u de eerste één of twee letters typt van de kenmerknaam of de kenmerkwaarde die u aan een tag wilt toevoegen, wordt de lijst automatisch aangepast aan de hand van de getypte letters.

Beperking: Voor Linux. Wanneer u Linux (Motif of GTK) gebruikt in een DBCS-locale, kan het dubbelklikken op de contenthulplijst er soms toe leiden dat de Java™ VM wordt beëindigd. In plaats van te dubbelklikken op de lijst kunt u de pijltjestoetsen en de Enter-toets gebruiken om in de lijst te selecteren.

JSP-contenthulp

U kunt Java- en HTML-code met contenthulp op twee manieren in JSP-pagina's opnemen.

Alle JSP-tags worden in XML-indeling opgenomen in de sjabloonlijst (bijvoorbeeld: <jsp:expressie>). Als u bijvoorbeeld een JSP-scriptlet-tags wilt opnemen, zet u de cursor op de gewenste plaats in het bestand en drukt u op Ctrl+spatiebalk om contenthulp op te roepen. Selecteer JSP-scriptlet
contenthulp in de lijst om <% %> in te voegen in het document.

Scriptlets worden ingevoegd tussen de tags <% %>. Voorbeeld:
<% System.currentTimeMillis() %>

Dit voorbeeld evalueert de Java-instructie waarmee de tijd wordt opgehaald in milliseconden.

Om het resultaat van de instructie in het bestand in te voegen, plaats u een is-teken (=) voor de instructie. Voorbeeld:
<b>Dit is de tijd: <%= System.currentTimeMillis()%></b>
Binnen een scriptlet gebruikt u pure Java-code. Contenthulp werkt daarom precies als in de Java-editor. Voorbeeld: Als u vraagt om contenthulp na System zal contenthulp een lijst van methoden afbeelden.
Opmerking: Java-contenthulp werkt alleen in een webproject, omdat een buildpad vereist is voor de juiste Java-klassen.
Er zijn ook speciale tags, zoals useBean. Voorbeeld:
<jsp:useBean id="useBean" class="java.lang.String"/>

Met de useBean-tag kunt u een bean maken met de naam aString en van het type String. Als u contenthulp gebruikt, wordt deze tag herkend als een gedeclareerde variabele. Voorbeeld: Als u contenthulp als volgt gebruikt na aString:

<% aString. %> 
toont contenthulp de beschikbare methoden. Dit omdat aString is gedeclareerd als een bean van het type String.
Als u contenthulp als volgt gebruikt na a:
<% a %> 
weet contenthulp dat aString bestaat en wordt deze afgebeeld in de lijst van contenthulp.
Verwante concepten
Editors voor gestructureerde tekst voor markuptalen
Verwante taken
Contenthulp opvragen in editors voor gestructureerde tekst
HTML-sjablonen toevoegen en verwijderen