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