Las inclusiones se utilizan para incluir partes de otros documentos en el documento. El código especifica el documento y el elemento a incluir y, antes de mostrar el documento al usuario, el elemento de inclusión se sustituirá por el elemento al que se hace referencia.
Por ejemplo, puede ser deseable mostrar un copyright al final de cada documento de ayuda proporcionado. Puede copiarlo y pegarlo en cada documento pero si el copyright cambia (p.ej. el año del copyright), debe modificar cada uno de los documentos.
En su lugar, puede colocar el copyright en un archivo XHTML aparte llamado copyright.xhtml
y asignarle un
identificador exclusivo como por ejemplo este:
<p id="copyright"> Copyright 2006 Mi Empresa. Reservados todos los derechos. </p>
Entonces, para cada documento, simplemente incluya el párrafo de copyright:
<p> Es es mi documento. Debe tener un copyright al final. </p> <include path="my.plugin.id/path/copyright.xhtml/copyright"/>
Antes de enviar el documento al navegador para que su visualización, el elemento include
se
sustituirá por el párrafo de copyright correspondiente.
A continuación se proporciona una lista de los tipos de documento en los que pueden utilizarse inclusiones. El formato
del elemento path
de la inclusión depende del tipo de documento origen de la inclusión. Como puede
ver en el ejemplo siguiente, el formato para los documentos de ayuda XHTML es
"<plugin_id>/<vía_de_acceso_al_archivo>/<id_de_elemento>"
. Consulte los enlaces siguientes para el conocer el formato
del tipo de documento.