Включения применяются для добавления частей других документов в данный документ. Текст на языке описания указывает на документ и включаемый элемент. Перед отображением документа для пользователя элемент include будет заменен элементом, на который он ссылается.
Например, может потребоваться показывать знак авторского права в конце каждого справочного документа. Можно скопировать и поместить его в каждый документ, однако если этот знак изменяется (например, год), то понадобится изменить каждый из этих документов.
Вместо этого можно поместить знак авторского права в отдельный файл XHTML
с именем copyright.xhtml
и присвоить ему уникальный идентификатор, например:
<p id="copyright"> Copyright 2006 Компания. Все права защищены. </p>
Затем в каждый документ следует просто включить абзац copyright:
<p> Это мой документ. Он должен содержать в конце знак авторского права. </p> <include path="my.plugin.id/path/copyright.xhtml/copyright"/>
Перед отправкой документа для отображения в браузере элемент include
будет заменен абзацем copyright.
Ниже приведен список документов, в которых можно использовать включения.
Формат элемента path
включения зависит от типа документа,
из которого поступает включение. Как показано в примере выше, справочные
документы XHTML имеют формат
"<ИД_модуля>/<путь_к_файлу>/<ИД_элемента>"
. Следуйте
приведенным ниже ссылкам для формата используемого типа документов.