Włączenia

Włączenia służą do umieszczania fragmentów innych dokumentów w dokumencie użytkownika. Za pomocą języka znaczników określa się dokument i element, który ma zostać włączony. Przed wyświetleniem dokumentu element włączenia jest zastępowany elementem, do którego się odwołuje.

Przykładem mogą być informacje o prawach autorskich umieszczane na końcu każdego udostępnianego dokumentu pomocy. Można je skopiować i wkleić do każdego dokumentu, ale jeśli ulegną zmianie (np. w przypadku zmiany roku ustanowienia praw autorskich), konieczne będzie zmodyfikowanie wszystkich dokumentów.

Zamiast tego informację o prawach autorskich można umieścić w osobnym pliku XHTML pod nazwą copyright.xhtml, przypisując mu unikalny identyfikator w sposób przedstawiony poniżej.

   <p id="copyright">
      Copyright 2006 Moja Firma. Wszelkie prawa zastrzeżone.
</p>

Następnie w każdym dokumencie umieszcza się następujący akapit dotyczący praw autorskich:

   <p>
      Tekst dokumentu, na końcu którego powinny znaleźć się informacje o prawach autorskich...
</p>
   <include path="identyfikator_wtyczki/ścieżka/copyright.xhtml/copyright"/>

Przed wysłaniem dokumentu do przeglądarki w celu wyświetlenia element include jest zastępowany akapitem dotyczącym praw autorskich.

Gdzie można stosować włączenia?

Poniżej znajduje się wykaz typów dokumentów, w których można korzystać z zakotwiczeń. Format elementu path zakotwiczenia zależy od typu dokumentu, z którego pobierana jest treść. Jak widać na powyższym przykładzie, w przypadku dokumentów pomocy XHTML stosowany jest format "<identyfikator_wtyczki>/<ścieżka_do_pliku>/<identyfikator_elementu>". Poniżej znajdują się odsyłacze do informacji dotyczących poszczególnych typów dokumentów.