Esittelyn sisällön määritys
Seuraavaksi tarkastellaan sisältöä. Sisältöä kuvataan sivuina. Kaikilla sivuilla on tunnusmäärite (id).
Käytä tätä tunnusta, kun haluat määrittää kotisivun ja valmiustilasivun tai muita sijainteja, joissa on viittaus sivuun. Muutoin olennaiset määritteet määräytyvät määritetyn sivun lajin mukaan.
Sivuja on kahta peruslajia:
- Staattiset sivut ovat tavallisia HTML-tiedostoja. Nämä sivut linkittyvät muihin sivuihin tavallisten HTML-merkintäkielen menetelmien avulla. Staattisia sivuja ei tarvitse määrittää määrityksen sisältötiedostoon muutoin kuin kotisivun osalta. Koska kotisivu määritetään tunnuksen perusteella (kotisivutunnus, home-page-id) presentation-elementissä, sisältötiedostossa on oltava kyseistä tunnusta käyttävä sivumääritys. Tällä sivulla tarvitsee määrittää vain url-osoite. Kaikki muut alielementit ohitetaan, koska HTML-sivu itse kuvaa sivun sisällön. Kaikki muut lisäosan lisäämät esittelyn HTML-sivut on sisällytettävä lisäosaan, mutta niitä ei tarvitse määrittää sisältötiedostossa. Viittauksia voi olla myös muissa lisäosissa tai WWW:ssä oleviin HTML-tiedostoihin.
- Dynaamiset sivut on kuvattu XML-sisältötiedostossa sellaisten alielementtien avulla, jotka kuvaavat sivun sisältöä. Alielementit ovat käyttöliittymän kohteita, joita on usein HTML-sivujen kaltaisilla sivuilla. Toteutuksen mukaan nämä sivut voidaan joko kääntää dynaamisesti HTML-muotoon (kun toteutuksen laji on html) tai luoda dynaamisesti SWT-perustaisina käyttöliittymän lomakkeina (kun toteutuksen laji on swt). Sivulle voi määrittää seuraavat alielementit:
- Elementin group avulla voit ryhmittää muita alielementtejä ja määrittää ryhmään yhdenmukaisen tyylin.
- Elementin link avulla voit määrittää linkin, jonka voi näyttää kuvana ja tekstinä. Linkki voi johtaa toiselle sivulle tai ajaa esittelytoiminnon. Toiminnot määritetään komentoina URL-osoitteessa.
- Elementit text ja img näyttävät teksti- ja kuvasisältöä.
- Elementti include sisältää aiemmin määritetyn alielementin. Elementtiin viitataan sen tunnuksella.
- Elementti head määrittää HTML-lisämerkinnän, joka sisällytetään sivun head-osaan, kun
käytössä on html-toteutus.
- Elementti html määrittää HTML-lisämerkinnän, joka sisällytetään sivun runko-osaan, kun
käytössä on html-toteutus.
Myös sivun otsikon (title) voi määrittää. Sivulla voi määrittää myös, että sen sisältö
määritetään erillisessä sisältötiedostossa. Sivujen pilkkominen erillisiin tiedostoihin voi olla käytännöllistä, kun suoritusteho on tärkeää, koska esittelysivun sisältöä ei alusteta, ennen kuin sitä tarvitaan.
Paras tapa perehtyä sisällön määritysmuotoon on selata toteutuksia Eclipse SDK -ympäristössä. Seuraavassa katkelmassa on esimerkki:
<introContent>
<page alt-style="css/root_swt.properties" style="css/root.css" id="root" style-id="page">
<title style-id="intro-header">Eclipse-ympäristön esittely</title>
<group id="links-background">
<group id="page-links">
<link label="Yleiskuvaus" url="http://org.eclipse.ui.intro/showPage?id=overview" id="overview" style-id="left">
<text>Eclipse-käyttöliittymän perusajatus</text>
</link>
<link label="Opetusohjelmat" url="http://org.eclipse.ui.intro/showPage?id=tutorials" id="tutorials" style-id="left">
<text>Eclipse-opetusohjelmat</text>
</link>
<link label="Mallit" url="http://org.eclipse.ui.intro/showPage?id=samples" id="samples" style-id="right">
<text>Eclipse-kehitysympäristöön tutustuminen koodimallien avulla</text>
</link>
<link label="Uudet ominaisuudet" url="http://org.eclipse.ui.intro/showPage?id=news" id="news" style-id="right">
<text>Tämän laitoksen uudet ominaisuudet</text>
</link>
</group>
</group>
...
Sivun elementit voi myös suodattaa (filteredFrom) tietystä toteutuksesta. Näin sivujen suunnittelijat
voivat laatia työnsä tiettyjä ympäristöjä varten. Voit käyttää muitakin tehokkaita määrityksiä, joiden avulla
voi kuvata sivua ja sen sisältöä. Katso laajennuspisteen
org.eclipse.ui.intro.config
dokumentaatio ja siihen liittyvä esittelyn sisältötiedoston muotomääritysten dokumentaatio, joissa on täydelliset ohjeet kelvollisista
elementeistä, alielementeistä ja niiden määritteistä.