Tartalmazások

A tartalmazások más dokumentumok részeinek adott dokumentumba felvételére használhatók. A kód megadja a felvenni kívánt dokumentumot és elemet, és mielőtt a dokumentum megjelenítésre kerülne a felhasználó számára, a tartalmazás elem helyettesítve lesz azzal elemmel, amelyre hivatkozott.

Elképzelhető például, hogy szerzői jogi részt kíván megjeleníteni minden biztosított dokumentum alján. Átmásolhatja és beillesztheti ezt minden dokumentumba, de ha a szerzői jog módosul (például az éve), akkor a dokumentumok mindegyikét módosítani kell.

Ehelyett a szerzői jogi szöveget megadhatja egy külön copyright.xhtml nevű XHTML fájlban és egy egyedi azonosítót rendelhet hozzá, például:

   <p id="copyright">
      Copyright 2006 Saját cég. Minden jog fenntartva.
   </p>

Ezután minden dokumentumba egyszerűen szúrja be a szerőzi jog bekezdést:

   <p>
      Ez az én dokumentumom. Ennek a végén szerzői jogi szövegnek kell szerepelnie.
   </p>
   <include path="my.plugin.id/path/copyright.xhtml/copyright"/>

Mielőtt a dokumentum elküldésre kerülne a böngészőnek megjelenítésre, az include elemet a rendszer a szerzői jogi bekezdéssel helyettesíti.

Hol használhatók tartalmazások?

Az alábbi lista azon dokumentumtípusokat tartalmazza, amelyekben tartalmazások használhatók. A tartalmazás path elemének formátuma azon dokumentum típusától függ, amelyből a tartalmazott elem származik. Ahogy a fenti példában látható, az XHTML súgódokumentumok formátuma: "<bedolgozó_azonosító>/<fájl_elérési_út>/<elem_azonosító>". A dokumentumtípus formátumáért tekintse meg az alábbi hivatkozásokat.