Med innehållshjälpen får du hjälp att infoga eller slutföra ett märkord eller en funktion eller att slutföra en kodrad i en redigerare för strukturerad text. När markören placeras i källfilen får innehållshjälpen den kontext som behövs för att du ska kunna få förslag.
De flesta redigerare för strukturerad text har innehållshjälp. En lista med redigerare som har innehållshjälp finns i Redigerare för strukturerad text för märkordsspråk. Mer information om hur du får innehållshjälp finns i Få innehållshjälp i redigerare för strukturerad text
I avsnitten nedan beskrivs HTML-innehållshjälp i detalj, JavaScript-innehållshjäl och JSP-innehållshjälp.
HTML är flexibelt på så sätt att vissa det är möjligt att utelämna slutmärkord för vissa HTML-element, till exempel P, DT, DD, LI, THEAD, TR, TD, TH osv. För andra HTML-element som är definierade att sakna innehåll kan det krävas att slutmärkordet alltid utelämnas, till exempel BR, HR, LINK, META och IMG. Den här flexibiliteten gör funktionen för innehållshjälp i redigeraren för HTML-källsidor mindre exakt än den kan vara med ett mer strikt begränsat märkordsspråk.
HTML-innehållshjälp är till störst nytta när du behöver slutföra ett märkordsnamn, lägga till ett värdepar för attributnamn i ett startmärkord eller välja i en numrerad lista med attributvärden.
Även om endast attributnamn visas i innehållshjälpen som inte redan har angetts i ett startmärkord, tas inte grammatiska begränsningar för märkord i beaktande. För exempelvis HEAD-elementet i HTML tillåts endast noll eller en förekomst av märkordet TITLE i innehållet. Om du begär innehållshjälp i ett HEAD-innehåll som redan innehåller ett TITLE-märkord, visas ändå TITLE i förslagslistan.
Om däremot ett attribut är obligatoriskt enligt DTD/Schema, visas det attributet överst i listan med en gul cirkelindikator på ikonen.
Om du placerar markören på en plats där det finns tillgänglig innehållshjälp visas de tillgängliga alternativen. Listan är baserad på kontexten. Om du till exempel använder innehållshjälp direkt efter ett inledande märkord för ett stycke (<p>), blir det första objektet i innehållshjälpens lista motsvarande slutmärkord för stycke (</p>) tag.
I innehållshjälpens lista visas alla tillgängliga märkord för den aktuella
markörpositionen, inklusive mallar. På bilderna nedan visas den förvalda
innehållshjälpslistan för ett styckemärkordsexempel:
Märkordsförslag visas alfabetiskt i listan. Om du skriver ett < (för att påbörja ett nytt märkord) innan du begär innehållshjälp, och börjar skriva den första eller två första bokstäverna i det märkord som du vill lägga till, uppdateras förslagslistan automatiskt för att återspegla förslag som stämmer med de mönster som du har skrivit. Om du inte skriver ett < innan du begär innehållshjälp, kan du klicka i förslagslistan och sedan skriva den bokstav som märkordet börjar på för att (något) minska hur mycket du måste bläddra för att hitta önskat märkord.
När du skriver den första eller två första bokstäverna i de attributnamn eller numrerade attributvärden som du vill lägga till i ett märkord, uppdateras förslagslistan automatiskt för att återspegla förslag som stämmer med de mönster som du har skrivit.
Du har många alternativ för att bädda in Java- och HTML-kod i JSP-sidor genom att använda innehållshjälp.
Alla JSP-märkord
är inkluderade både i mallistan och i XML-format (till exempel, <jsp:uttryck>).
Om du till exempel vill lägga till JSP-scriptletmärkord, flyttar du markören till lämplig
position i filen och trycker på Ctrl+blanktecken när du vill använda innehållshjälpen. Välj i förslagslistan om du vill infoga <% %> i
dokumentet.
<% System.currentTimeMillis() %>
Med det här exemplet utvärderas Java-satsen för att erhålla den aktuella tiden i millisekunder.
<b>Detta är tiden: <%= System.currentTimeMillis()%></b>
<jsp:useBean id="useBean" class="java.lang.String"/>
Med hjälp av märkordet useBean kan du skapa en böna med namnet aString av typen String. När du sedan använder innehållshjälp identifieras den som en deklarerad variabel. Om du till exempel använder innehållshjälp efter aString på följande sätt:
<% aString. %>visas tillgängliga metoder i innehållshjälpens lista. Det beror på att aString har deklarerats som en böna av typen String.
<% a %>vet innehållshjälpen att aString finns och den visas i innehållshjälpens lista.