Acerca de las plantillas de Dreamweaver

Una plantilla es un tipo especial de documento que sirve para crear un diseño de página “fijo”; puede crear documentos basados en la plantilla que heredan su diseño de página. Al diseñar una plantilla, usted especifica como “editables” aquellos contenidos de un documento basado en dicha plantilla que los usuarios pueden editar. Las plantillas permiten a los autores controlar qué elementos de la página pueden editar los usuarios de la plantilla (como los redactores, los diseñadores gráficos y otros desarrolladores Web). El autor de una plantilla puede incluir varios tipos de regiones de plantilla en un documento.

La utilización de plantillas le permite actualizar varias páginas a la vez. Un documento que se crea a partir de una plantilla permanece conectado a ella (a menos que separe el documento posteriormente). Puede modificar una plantilla e inmediatamente actualizar el diseño en todos los documentos basados en ella.

Al guardar un documento como plantilla, se bloquean la mayoría de las regiones del documento. Como autor de la plantilla, debe especificar qué regiones del documento basado en plantilla serán editables insertando regiones editables o parámetros editables en la plantilla.

A medida que cree la plantilla, podrá realizar cambios tanto en las regiones editables como en las bloqueadas. Sin embargo, en un documento basado en plantilla, el usuario de la plantilla solo podrá realizar cambios en las regiones editables, no en las regiones bloqueadas.

Una plantilla contiene cuatro tipos de regiones:

Una región editable: una región no bloqueada dentro de un documento basado en plantilla, es decir, una sección que el usuario de la plantilla puede editar. El autor de una plantilla puede especificar cualquier área de la plantilla como editable. Para que una plantilla sea eficaz, deberá contener al menos una región editable. En caso contrario, las páginas basadas en la plantilla no se podrán editar. Para obtener información detallada sobre las regiones editables, consulte Crear regiones editables en plantillas de Dreamweaver.

Un región repetida: una sección del diseño del documento que se ha definido de tal modo que el usuario de la plantilla pueda añadir o eliminar copias de la región repetida en un documento basado en la plantilla según necesite. Por ejemplo, puede definir que una fila de una tabla se repita. Las secciones repetidas son editables para que el usuario de la plantilla pueda editar el contenido del elemento repetido, mientras que el diseño propiamente dicho está controlado por el autor de la plantilla.

Existen dos tipos de regiones repetidas que se pueden insertar en una plantilla: región repetida y tabla repetida. Para saber cómo trabajar con las regiones repetidas, consulte Creación de regiones y tablas repetidas en Dreamweaver.

Una región opcional: una sección de una plantilla en la que hay contenido (como texto o una imagen) que puede aparecer o no en un documento. En la página basada en la plantilla, el usuario de la plantilla suele controlar si el contenido se mostrará o no. Para obtener más información, consulte la sección Región opcional.

Un atributo de etiqueta editable: permite desbloquear un atributo de etiqueta de una plantilla de modo que el atributo pueda editarse en una página basada en plantilla. Por ejemplo, puede "bloquear" qué imagen aparece en el documento, pero dejar que el usuario de la plantilla establezca la alineación a la izquierda, a la derecha o central. Para más información, consulte Definir atributos de etiqueta editables en Dreamweaver.

Vínculos de plantillas

Cuando se crea un archivo de plantilla guardando como plantilla una página existente, la nueva plantilla en la carpeta Templates, así como los vínculos contenidos en el archivo, se actualizan de manera que los vínculos relativos al documento sean correctos. Posteriormente, cuando se crea un documento basado en esa plantilla y luego se guarda, se actualizan de nuevo todos los vínculos relativos al documento para que continúen señalando a los archivos correctos.

Si se añade un nuevo vínculo relativo al documento a un archivo de plantilla y se escribe la ruta en el cuadro de texto del vínculo en el inspector de propiedades, es fácil introducir un nombre de ruta erróneo. La ruta correcta en un archivo de plantilla es la ruta desde la carpeta Templates hasta el documento vinculado, no la ruta desde la carpeta del documento basado en plantilla hasta el documento vinculado. Asegúrese de que utiliza las rutas correctas para los vínculos empleando el icono de carpeta o el icono de señalización de archivo en el inspector de propiedades al crear vínculos en plantillas.

Scripts de servidor en plantillas y documentos basados en plantillas

Algunos scripts de servidor se insertan al principio o al final del documento (antes de la etiqueta <html> o después de la etiqueta </html>). Estos scripts requieren un tratamiento especial en plantillas y documentos basados en plantilla. Normalmente, si realiza cambios en el código del script antes de la etiqueta <html> o después de la etiqueta </html> de una plantilla, los cambios no se copian en documentos basados en esa plantilla. Esto puede ocasionar errores en el servidor si otros scripts de servidor que se encuentran en el cuerpo principal de la plantilla dependen de los scripts que no se copian. Se le avisará si realiza cambios en los scripts antes de la etiqueta <html> o después de la etiqueta </html> en una plantilla.

Para evitar este problema puede insertar el código siguiente en la sección head de la plantilla.

Cuando este código se encuentra en una plantilla, los cambios realizados en los script antes de la etiqueta <html> o después de la etiqueta </html> se copiarán en documentos basados en esa plantilla. Sin embargo, no podrá volver a editar esos scripts en documentos basados en la plantilla. De este modo, debe elegir entre editar estos scripts en la plantilla o en los documentos basados en la plantilla, pero no en ambos.

Parámetros de plantilla

Los parámetros de plantilla contienen valores para controlar el contenido de los documentos basados en una plantilla. Utilice los parámetros de plantilla para definir regiones opcionales y atributos de etiqueta editables o para establecer valores que desea transferir a un documento adjunto. Seleccione un nombre, un tipo de datos y un valor predeterminado para cada parámetro. Cada parámetro debe tener un nombre exclusivo en el que se distingue el uso de mayúsculas y minúsculas. Debe ser de uno de los cinco tipos de datos permitidos: texto, booleano, color, URL o número.

Los parámetros de plantilla se pasan al documento como parámetros de instancia. En la mayoría de los casos el usuario de la plantilla puede editar el valor predeterminado del parámetro para personalizar lo que aparece en un documento basado en plantilla. En otros casos, el creador de la plantilla podría determinar lo que debe aparecer en el documento en función del valor de una expresión de plantilla.

Expresiones de plantilla

Las expresiones de plantilla son declaraciones que calculan o evalúan un valor.

Puede utilizar una expresión para almacenar un valor y mostrarlo en un documento. Por ejemplo, una expresión puede ser tan simple como el valor de un parámetro, como @@(Param)@@, o lo bastante compleja como para calcular valores que alternan el color de fondo de la fila de una tabla, como @@((_index & 1) ? red : blue)@@.

También puede definir expresiones para las condiciones if y multiple-if. Cuando se usa una expresión en una declaración condicional, Dreamweaver la evalúa como true o false. Si la condición es verdadera, la región opcional aparece en el documento basado en plantilla; si es falsa, no aparece.

Puede definir expresiones en la vista de Código o en el cuadro de diálogo Región opcional al insertar una región opcional.

En la vista de Código, existen dos maneras de definir las expresiones de plantilla: utilice el comentario <!-- TemplateExpr expr="su expresión"--> o @@(su expresión)@@. Cuando se inserta la expresión en el código de plantilla, aparece un marcador de expresión en la vista de Diseño. Cuando aplique la plantilla, Dreamweaver evaluará la expresión y mostrará el valor en el documento basado en la plantilla.

Lenguaje de expresiones de plantilla

El lenguaje de expresiones de plantilla es un pequeño subconjunto de JavaScript y utiliza la sintaxis y las reglas de prioridad de JavaScript. Utilice operadores JavaScript para escribir una expresión como esta:

Se admiten los siguientes operadores y funciones:

• literales numéricos, literales de cadena (solo sintaxis de comillas dobles), literales booleanos (true o false)

• referencia de variable (consulte la lista de variables definidas más adelante en esta sección)

• referencia de campo (el operador “dot”)

• operadores unarios: +, -, ~, !

• operadores binarios: +, -, *, /, %, &, |, ^, &&, ||, <, <=, >, >=, ==, !=, <<, >>

• operador condicional: ?:

• paréntesis: ()

  Se utilizan los siguientes tipos de datos: booleanos, coma flotante IEEE de 64 bpc, cadena y objeto. Las plantillas de Dreamweaver no admiten el uso de tipos JavaScript “nulos” o “no definidos”. Tampoco permiten convertir implícitamente tipos escalares en un objeto. Por tanto, la expresión "abc".length desencadenaría un error, en lugar de producir el valor 3.

  Los únicos objetos disponibles son los definidos por el modelo de objetos de expresión. Se definen las variables siguientes:

  _document

  Contiene los datos de plantilla correspondientes al nivel del documento con un capo de cada parámetro.

  _repeat

  Solo se define para expresiones que aparecen dentro de una región repetida. Proporciona información incorporada sobre la región

  _index

  Índice numérico (desde 0) de la entrada actual

  _numRows

  Número total de entradas de esta región repetida

  _isFirst

  Verdadero (true) si la entrada actual es la primera de su región repetida

  _isLast

  Verdadero (true) si la entrada actual es la última de su región repetida

  _prevRecord

  El objeto _repeat para la entrada anterior. Es un error acceder a esta propiedad para la primera entrada de la región.

  _nextRecord

  El objeto _repeat para la entrada siguiente. Es un error acceder a esta propiedad para la última entrada de la región.

  _parent

  En una región repetida anidada, proporciona el objeto _repeat para la región repetida exterior. Es un error acceder a esta propiedad fuera de una región repetida anidada.

  Durante una evaluación de expresión, todos los campos de los objetos _document y _repeat están disponibles implícitamente. Por ejemplo, puede introducir title en lugar de _document.title para acceder al parámetro de título del documento.

  En los casos en que haya un conflicto entre campos, los campos del objeto _repeat tienen prioridad sobre los campos del objeto _document. Por tanto, no debería ser necesario hacer referencia explícita a _document o _repeat salvo que se necesite _document dentro de una región repetida para hacer referencia a parámetros de documento que están ocultos por parámetros de región repetida.

  Cuando se utilizan regiones repetidas anidadas, solo están disponibles implícitamente los campos de las regiones repetidas más interiores. Para hacer referencia explícita a las regiones exteriores se debe utilizar _parent.

Condición multiple if en el código de plantilla

Puede definir expresiones de plantilla para las condiciones if y multiple-if. En este ejemplo se define un parámetro llamado "Dept", se establece un valor inicial y se define una condición multiple-if que determina qué logotipo se debe mostrar.

A continuación se proporciona un ejemplo del código que puede introducir en la sección head de la plantilla:

La declaración condicional siguiente comprueba el valor asignado al parámetro Dept. Cuando la condición es verdadera o coincide, se mostrará la imagen apropiada.

Cuando se crea un documento basado en una plantilla, se le transfieren automáticamente los parámetros de plantilla. El usuario de la plantilla determina qué imagen se mostrará.