併入用來將其他文件的某些部分併到您的文件中。 這個標記指定要併入的文件和元素,在文件呈現給使用者之前,會以所參照的元素來取代 include 元素。
例如,您可能會想在所提供的每份說明文件的尾端顯示版權。 您可以複製它,將它貼在每份文件中,但如果版權有了改變(如版權年份),您便必須修改每一份文件。
您可以改成將文件放在稱為 copyright.xhtml
的個別 XHTML 檔中,再指派它的唯一 ID,例如:
<p id="copyright"> Copyright 2006 My Company. All rights reserved. </p>
之後,每份文件都只需要併入下列版權段落:
<p> This is my document. It should have a copyright at the end. </p> <include path="my.plugin.id/path/copyright.xhtml/copyright"/>
在文件傳給瀏覽器顯示之前,會以版權段落來取代 include
元素。
請參閱下文,以取得能夠使用併入的文件類型清單。
併入的 path
元素格式會隨著併入的來源文件類型而不同。
如您上述範例中所見,XHTML 說明文件的格式是 "<plugin_id>/<path_to_file>/<element_id>"
。
請參閱下面的鏈結,以瞭解文件類型的格式。