Sisällönhallinnan aputoiminto

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-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ä:
HTML-sisällönhallinnan aputoiminto

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

Rajoitus: Linux-käyttöjärjestelmät. Linux-käyttöliittymää varten. Jos käytössä on Linux-käyttöliittymä (Motif tai GTK) ja DBCS-paikallistunnus, sisällönhallinnan aputoiminnon luettelon kaksoisnapsautus saattaa joskus sulkea Java™-näennäiskoneen. Älä siis kaksoisnapsauta luetteloa, vaan valitse haluamasi kohde luettelosta nuolinäppäimien ja Enter-näppäimen avulla.

JSP-sisällönhallinnan aputoiminto

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 JSP-komentosarjasovelman sisällönhallinnan aputoiminto, niin järjestelmä lisää asiakirjaan määritteen <% %>.

Komentosarjasovelmat lisätään <% %>-määritteeseen. Esimerkki:
<% System.currentTimeMillis() %>

Tämän esimerkin koodi noutaa järjestelmästä nykyisen kellonajan millisekunteina ilmaistuna Java-käskyn arvioinnin tuloksena.

Jos haluat sisällyttää lausekkeen tuloksen tiedostoon, käytä lausekkeen alussa yhtäsuuruusmerkkiä (=). Esimerkki:
<b>Kello on: <%= System.currentTimeMillis()%></b>
Komentosarjasovelman sisälle on kirjoitettava puhdasta Java-koodia. Näin ollen sisällönhallinnan aputoiminto toimii aivan samalla tavalla kuin Java-muokkausohjelmassa. Jos esimerkiksi pyydät sisällönhallinnan aputoimintoa System-määritteen jälkeen, sisällönhallinnan aputoiminto tuo näyttöön metodiluettelon.
Huomautus: Java-sisällönhallinnan aputoiminto toimii vain Web-projektissa, koska se tarvitsee koontipolun löytääkseen oikeat Java-luokat.
Käytettävissä on myös erikoistunnisteita, kuten useBean-komponentti. Esimerkki:
<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.
Voit käyttää sisällönhallinnan aputoimintoa a-kirjaimen jälkeen:
<% a %> 
Tällöin sisällönhallinnan aputoiminto tietää, että aString-vaihtoehto on olemassa, ja se näkyy sisällönhallinnan aputoiminnon luettelossa.
Aiheeseen liittyviä käsitteitä
Rakenteiset tekstin muokkausohjelmat merkintäkieliä varten
Aiheeseen liittyviä tehtäviä
Sisällönhallinnan aputoiminto rakenteisen tekstin muokkausohjelmissa
HTML-mallipohjien lisäys ja poisto