Sisällönhallinnan aputoiminnon avulla voit lisätä tai täydentää tunnisteita tai toimintoja sekä täydentää koodirivejä rakenteisen tekstin muokkausohjelmassa. Kohdistimen sijainti lähdetiedostossa toimii kontekstina sisällönhallinnan aputoiminnolle, joka lisää täydennysehdotuksia.
Useimpiin rakenteisen tekstin muokkausohjelmiin liittyy sisällönhallinnan aputoiminto. Ohjeaiheessa Rakenteisen tekstin muokkausohjelmat merkintäkieliä varten on luettelo muokkausohjelmista, joissa on sisällönhallinnan aputoiminto. Lisätietoja sisällönhallinnan aputoiminnon käytöstä on ohjeaiheessaSisällönhallinnan aputoiminto rakenteisen tekstin muokkausohjelmissa.
Seuraavissa osissa kuvataan HTML-sisällönhallinnan aputoiminto, JavaScript™-sisällönhallinnan aputoiminto ja JSP-sisällönhallinnan aputoiminto.
HTML-koodi on sikäli joustavaa, että jotkin HTML-elementit sallivat lopputunnisteiden poisjätön. Tällaisia elementtejä ovat esimerkiksi P, DT, DD, LI, THEAD, TR, TD ja TH. Joissakin HTML-elementeissä ei määrityksen mukaan ole sisältöä, joten niistä lopputunniste on aina jätettävä pois. Tällaisia elementtejä ovat BR, HR, LINK, META ja IMG. Tämän joustavuuden vuoksi sisällönhallinnan aputoiminnon toiminta HTML-lähdesivun muokkausohjelmassa ei ole yhtä tarkkaa kuin tarkemmin määritettyä merkintäkieltä käytettäessä.
HTML-sisällönhallinnan aputoiminto on hyödyllisin, kun tunnisteen nimi on täydennettävä, alkutunnisteeseen on lisättävä määritteen nimi ja arvo -pari tai määritearvo on valittava luettelosta.
Sisällönhallinnan aputoiminto näyttää vain sellaiset määritenimet, joita ei ole vielä määritetty aloitustunnisteessa, mutta se ei ota huomioon tunnisteiden kielioppirajoitteita. HTML-koodin HEAD-elementti esimerkiksi sallii sisällössään vain nolla tai yksi TITLE-tunnisteen esiintymää. Jos kutsut sisällönhallinnan aputoimintoa HEAD-sisällössä, jossa on jo TITLE-tunniste, sisällönhallinnan aputoiminto näyttää kuitenkin TITLE-tunnisteen ehdotusluettelossaan.
Jos määrite on pakollinen DTD- tai skeemamäärityksen mukaan, kyseinen määrite näkyy luettelon yläosassa ja sen kuvakkeessa on keltainen ympyräilmaisin.
Jos kohdistin on paikassa, jossa sisällönhallinnan aputoiminto on käytettävissä, näkyviin tulee ponnahdusluettelo käytettävissä olevista vaihtoehdoista. Luettelo perustuu kontekstiin. Jos esimerkiksi käytät sisällönhallinnan aputoimintoa heti kappaleen avaustunnisteen (<p>) jälkeen, sisällönhallinnan aputoiminnon luettelossa näkyy ensimmäisenä kohteena vastaava sulkemistunniste (</p>).
Sisällönhallinnan aputoiminnon luettelossa näkyvät kaikki käytettävissä olevat kohdistimen nykyiseen sijaintipaikkaan sopivat tunnisteet, mallipohjat mukaan luettuina. Alla olevassa kuvassa näkyy sisällönhallinnan aputoiminnon
oletusluettelo kappaletunniste-esimerkissä:
Tunniste-ehdotukset ovat luettelossa aakkosjärjestyksessä. Jos kirjoitat <-merkin (uuden tunnisteen aloitusta varten), ennen kuin avaat sisällönhallinnan aputoimintoa, ja alat kirjoittaa lisättävän tunnisteen ensimmäisiä kirjaimia, ehdotusluettelo päivittyy automaattisesti ja näyttää ehdotukset, jotka vastaavat kirjoitettuja merkkejä. Jos et kirjoita <-merkkiä ennen sisällönhallinnan aputoiminnon avausta, voit napsauttaa ehdotusluetteloa ja kirjoittaa haluamasi tunnisteen alkukirjaimen, jolloin halutun tunnisteen luokse pääsyyn tarvitaan (hieman) vähemmän vieritystä.
Jos kirjoitat ensimmäiset kirjaimet tunnisteeseen lisättävän määritteen nimestä tai luetellun määritteen arvosta, luettelo päivittyy automaattisesti ja näyttää ehdotukset, jotka vastaavat kirjoitettuja merkkejä.
Voit upottaa Java- ja HTML-koodia JSP-sivuihin monella tavalla käyttämällä sisällönhallinnan aputoimintoa.
Kaikki JSP-määritteet sisältyvät sekä mallipohjaluetteloon että XML-muotoon (esimerkiksi <jsp:expression>).
Jos haluat lisätä esimerkiksi JSP-komentosarjasovelman määritteitä, siirrä kohdistin haluamaasi paikkaan tiedostossa ja käytä sisällönhallinnan aputoimintoa painamalla näppäinyhdistelmää Ctrl+Välilyönti. Valitse ehdotusluettelosta , niin järjestelmä lisää asiakirjaan määritteen <% %>.
<% System.currentTimeMillis() %>
Tämän esimerkin koodi noutaa järjestelmästä nykyisen kellonajan millisekunteina ilmaistuna Java-käskyn arvioinnin tuloksena.
<b>Kello on: <%= System.currentTimeMillis()%></b>
<jsp:useBean id="useBean" class="java.lang.String"/>
Käyttämällä useBean-tunnistetta voit luoda bean-komponentin, jonka nimi on aString ja tietolaji String. Kun sitten käytät sisällönhallinnan aputoimintoa, järjestelmä tunnistaa kohteen esitellyksi muuttujaksi. Voit esimerkiksi käyttää sisällönhallinnan aputoimintoa aString-tunnisteen jälkeen:
<% aString. %>Tällöin sisällönhallinnan aputoiminto näyttää käytettävissä olevat metodit. Tämä johtuu siitä, että aString-tunniste on esitelty String-tietolajin bean-komponentiksi.
<% a %>Tällöin sisällönhallinnan aputoiminto tietää, että aString-vaihtoehto on olemassa, ja se näkyy sisällönhallinnan aputoiminnon luettelossa.