Definición y uso¶
El elemento <importNCL> permite incorporar otro documento NCL especificación. Como consecuencia, todas las bases definidas dentro de la NCL importada documento, así como el elemento documento <body>, se importan, todo en una vez. Las bases serán tratadas como si cada una hubiera sido importada por <importBase> elementos. El elemento <body> importado se tratará como un <context> elemento. Cabe destacar que el elemento <importNCL> no "incluir" el documento NCL referido pero solo hace que el documento referido visible para que sus componentes sean reutilizados por el documento que ha definido el <importNCL> elemento. Así, el <body> importado, así como cualquiera de sus nodos contenidos, se pueden reutilizar dentro del elemento <body> de la importación Documento NCL.
El atributo documentURI del elemento <importNCL> hace referencia a un URI correspondiente al documento NCL a importar. El atributo alias especifica un nombre que se utilizará como prefijo cuando se haga referencia a elementos de este documento importado. La referencia debe tener el formato: alias#element_id. eso Es importante tener en cuenta que se debe utilizar el mismo alias cuando se hace referencia a elementos definidos en las bases de documentos importadas indirectamente (<regionBase>, <connectorBase>, <descriptorBase>, etc.).
La operación de importación es transitiva, es decir, si baseA importa baseB que importa baseC, luego baseA importa baseC. Sin embargo, el alias definido para baseC dentro de baseBi no es considerada por baseA.
Sintaxis¶
| Elemento | Atributos | Contenido | Padre |
|---|---|---|---|
| <importNCL> | alias, documentURI | -- | <importedDocumentBase> |
Atributos¶
| Nombre | Valor | Descripción |
|---|---|---|
| alias | Puede recibir cualquier valor de cadena que comience con una letra o un guión bajo y que solo contenga letras, dígitos, <"."> y <"_">. | El atributo alias especifica un nombre que se utilizará como prefijo cuando se haga referencia a elementos de la base importada. El valor alias debe ser único en un documento y su alcance está restringido al documento que ha definido el atributo alias. |
| documentURI | URI. | El atributo documentURI es el localizador del documento NCL desde donde se importará la base o el documento. |