A tartalomsegéd segíti a címkék vagy függvények beszúrását vagy befejezését, illetve a kódsorok befejezését a strukturáltszöveg-szerkesztőkben. A forrásfájlban a kurzor elhelyezése biztosítja a kontextust a tartalomsegéd számára a befejezési javaslatok felajánlásához.
A legtöbb strukturáltszöveg-szerkesztő rendelkezik tartalomsegéddel. A tartalomsegéddel rendelkező szerkesztők listájáért nézze meg a Jelölőnyelvek strukturáltszöveg-szerkesztői című részt. A tartalomsegéd előhívásának módjával kapcsolatos információkért nézze meg a Tartalomsegéd előhívása a strukturáltszöveg-szerkesztőkben című részt.
Az alábbi részek a HTML tartalomsegéd, a JavaScript™ tartalomsegéd és a JSP tartalomsegéd jellemzőit mutatják be.
A HTML rugalmas abból a szempontból, hogy bizonyos HTML elemek záró címkéi nem kötelezően elhagyhatók, például P, DT, DD, LI, THEAD, TR, TD, TH és így tovább. Más HTML elemek, amelyek úgy vannak meghatározva, hogy nem rendelkeznek tartalommal, megkívánhatják a záró címke kötelező elhagyását, például BR, HR, LINK, META és IMG. Ezen rugalmasság miatt a HTML forrásoldal-szerkesztő tartalomsegéd funkciója kevésbé precíz, mint egy sokkal szigorúbban szabályozott nyelv esetén lenne.
A HTML tartalomsegéd akkor a leghasznosabb, ha címkenevet kell kiegészítenie, attribútum név-érték párt kell felvennie egy kezdő címkén belül, vagy attribútumértékek számozott listájából kell választania.
Habár a tartalomsegéd csak azokat az attribútumneveket mutatja, amelyek már meg lettek adva egy kezdő címkében, nem veszi figyelembe a címkék nyelvtani megszorításait. Például a HEAD HTML elem csak a TITLE címke nulla vagy egy előfordulását engedi meg tartalmában. Ha a tartalomsegéd segítségét kéri egy olyan HEAD tartalmon belül, ami már tartalmaz egy TITLE címkét, akkor a tartalomsegéd még mindig a TITLE címkét mutatja a javaslatok listájában.
Ha azonban a DTD/séma szerint egy attribútum kötelező, akkor az az attribútum a lista tetején jelenik meg, egy sárga kör jelzéssel az ikonján.
Ha a kurzor olyan helyen van, ahol elérhető tartalomsegéd, akkor előugrik a lehetőségeket tartalmazó lista. A lista a kontextuson alapul. Ha például a tartalomsegédet közvetlenül egy bekezdés kezdete címke (<p>) után használja, akkor a tartalomsegéd által javasolt első elem a megfelelő bekezdés vége (</p>) címke lesz.
A tartalomsegéd listája
az aktuális kurzorpozícióhoz rendelkezésre álló összes címkét megjeleníti,
beleértve a sablonokat is. Az alábbi ábrán az alapértelmezett tartalomsegéd
lista látható egy bekezdés címke példához:
A címke javaslatok ábécérendben követik egymást. Ha a tartalomsegéd meghívása előtt beír egy < karaktert (új címke elkezdéséhez), majd beírja a hozzáadni kívánt címke első egy-két betűjét, akkor a javaslatlista automatikusan frissül, hogy a beírt mintának megfelelő javaslatokat tükrözze. Ha nem ír be < karaktert a tartalomsegéd meghívása előtt, akkor rákattinthat a javaslatok listájára, majd beírhatja a címke kezdőbetűjét a kívánt címke megkereséséhez szükséges görgetés (némi) csökkentése érdekében.
Ahogy beírja a címkékhez hozzáadni kívánt attribútumnevek vagy számozott attribútumértékek első egy-két betűjét, a javaslatlista automatikusan frissül, hogy a beírt mintának megfelelő javaslatokat tükrözze.
Sokféleképpen beágyazhat Java és HTML kódot a JSP oldalakba a tartalomsegéd használatával.
Az
összes JSP címke benne van a sablon listában és az XML formátumban
(például <jsp:expression>).
JSP scriptlet címkék hozzáadásához például menjen a kurzorral a megfelelő
pozícióba a fájlban, és nyomja le a Ctrl+szóköz billentyűkombinációt a
tartalomsegéd használatához. Válassza a
lehetőséget a javaslatok
listájából a <% %> beillesztéséhez a dokumentumba.
<% System.currentTimeMillis() %>
Ez a példa a Java utasítást fogja kiértékelni az aktuális idő beszerzéséhez (ezredmásodpercben).
<b>Ez a pontos idő : <%= System.currentTimeMillis()%></b>
<jsp:useBean id="useBean" class="java.lang.String"/>
A useBean címke lehetővé teszi egy aString nevű komponens létrehozását String típussal. Majd amikor tartalomsegédet használ, akkor ezt felismeri a rendszer és változóként deklarálja. Például ha az alábbiak szerint tartalomsegédet használ az aString után:
<% aString. %>akkor a tartalomsegéd lista rendelkezésre álló metódusokat jelenít meg. Ez azért van, mert az aString String típusú komponensként lett deklarálva.
<% a %>akkor a tartalomsegéd tudja, hogy az aString létezik, és megjeleníti a tartalomsegéd listában.