Acerca de las plantillas de Dreamweaver

Una plantilla es un tipo especial de documento que se usa para diseñar un formato de página «fijo»; puedes crear documentos basados en la plantilla que heredan su formato de página.Al diseñar una plantilla, especificas como "editables" qué contenidos pueden editar los usuarios en un documento basado en esa plantilla. Las plantillas permiten que los autores de plantillas controlen qué elementos de página pueden editar los usuarios de plantillas, como escritores, artistas gráficos u otros desarrolladores web. Hay varios tipos de regiones de plantilla que el autor de la plantilla puede incluir en un documento.

La utilización de plantillas le permite actualizar varias páginas a la vez. Un documento que se crea desde una plantilla permanece conectado a esa plantilla (a menos que desconectes el documento más tarde). Puedes modificar una plantilla y actualizar inmediatamente el diseño en todos los documentos basados en ella.

Tipos de regiones de plantillas

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 creas un archivo de plantilla guardando una página existente como plantilla, la nueva plantilla en la carpeta Templates y cualquier enlace en el archivo se actualiza para que sus rutas relativas al documento sean correctas. Más tarde, cuando creas un documento basado en esa plantilla y lo guardas, todos los enlaces relativos al documento se actualizan de nuevo para seguir apuntando a los archivos correctos.

Cuando agregas un nuevo enlace relativo al documento a un archivo de plantilla, es fácil introducir el nombre de ruta incorrecto si escribes la ruta en el cuadro de texto del enlace en el inspector de propiedades. La ruta correcta en un archivo de plantilla es la ruta desde la carpeta Templates al documento enlazado, no la ruta desde la carpeta del documento basado en plantilla al documento enlazado. Asegúrate de que existan las rutas correctas para los enlaces usando el icono de carpeta o el icono Apuntar a archivo en el inspector de propiedades al crear enlaces en plantillas.

Scripts de servidor en plantillas y documentos basados en plantillas

Algunos scripts de servidor se insertan al comienzo o al final del documento (antes de la etiqueta <html> o después de la etiqueta </html>). Estos scripts requieren tratamiento especial en plantillas y documentos basados en plantillas.Normalmente, si realizas cambios en el código de script antes de la etiqueta <html> o después de la etiqueta </html> en una plantilla, los cambios no se copian a los documentos basados en esa plantilla.Esto puede causar errores del servidor si otros scripts del servidor, dentro del cuerpo principal de la plantilla, dependen de los scripts que no se copian.Una alerta te advierte si cambias scripts antes de la etiqueta <html> o después de la etiqueta </html> en una plantilla.

Para evitar este problema, puedes insertar el siguiente código en la sección head de la plantilla:

<!-- TemplateInfo codeOutsideHTMLIsLocked="true" -->

Cuando este código está en una plantilla, los cambios a los scripts antes de la etiqueta <html> o después de la etiqueta </html> se copian a documentos basados en esa plantilla.Sin embargo, ya no podrás editar esos scripts en documentos basados en la plantilla. Así, puedes elegir editar estos scripts ya sea en la plantilla o en los documentos basados en la plantilla, pero no ambos.

Parámetros de plantilla

Los parámetros de plantilla indican valores para controlar el contenido en documentos basados en una plantilla. Utilice parámetros de plantilla para regiones opcionales o atributos de etiqueta editables, o para establecer valores que desee pasar a un documento adjunto. Para cada parámetro, selecciona un nombre, un tipo de datos y un valor predeterminado.Cada parámetro debe tener un nombre único que distinga entre mayúsculas y minúsculas.Deben ser 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, un usuario de plantilla puede editar el valor predeterminado del parámetro para personalizar lo que aparece en un documento basado en plantilla. En otros casos, el autor de la plantilla podría determinar lo que aparece en el documento, basándose en el valor de una expresión de plantilla.

Expresiones de plantilla

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

Puedes utilizar una expresión para almacenar un valor y mostrarlo en un documento.Por ejemplo, una expresión puede ser tan sencilla como el valor de un parámetro, como @@(Param)@@, o lo suficientemente compleja como para calcular valores que alternen el color de fondo en una fila de 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.

Puedes definir expresiones en la vista Código o en el cuadro de diálogo Región opcional cuando insertes una región opcional.

En la vista Código, hay dos formas de definir expresiones de plantilla: usar el comentario <!-- TemplateExpr expr=&quot;your expresson&quot;--> o @@(your expression)@@.Al insertar la expresión en el código de plantilla, aparece un marcador de expresión en la vista Diseño.Cuando aplicas la plantilla, Dreamweaver evalúa la expresión y muestra el valor en el documento basado en plantilla.

Lenguaje de expresiones de plantilla

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

@@(firstName+lastName)@@

Se admiten los siguientes operadores y funciones:

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

• referencia de variable (vea 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: Booleano, punto flotante IEEE 64‑bpc, cadena y objeto. Las plantillas de Dreamweaver no admiten el uso de tipos JavaScript "null" o "undefined". Tampoco permiten que los tipos escalares se conviertan implícitamente en un objeto; por tanto, la expresión "abc".length activaría un error, en lugar de producir el valor 3.

  Los únicos objetos disponibles son aquellos definidos por el modelo de objeto de expresión. Las siguientes variables están definidas:

  _document

  Contiene los datos de plantilla a nivel de documento con un campo para cada parámetro de la plantilla.

  _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 si la entrada actual es la primera entrada en su región repetida

  _isLast

  Verdadero si la entrada actual es la última entrada en su región repetida

  _prevRecord

  El objeto _repeat para la entrada anterior. Es un error acceder a esta Propiedad para la primera entrada en el área geográfica.

  _nextRecord

  El objeto _repeat para la entrada siguiente. Error al acceder a esta propiedad para la última entrada en la región.

  _parent

  En una región repetida anidada, esto proporciona el objeto _repeat para la región repetida envolvente (exterior).Es un error acceder a esta Propiedad fuera de un área geográfica repetida anidada.

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

  En casos donde hay un conflicto de campos, los campos del objeto _repeat tienen prioridad sobre los campos del objeto _document.Por lo tanto, no deberías necesitar referenciar explícitamente _document o _repeat excepto que _document podría ser necesario dentro de un área geográfica repetida para referenciar parámetros de documento que están ocultos por parámetros de área geográfica repetida.

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

Múltiples condiciones If en el código de plantilla

Puedes definir expresiones de plantilla para condiciones if y condiciones if múltiples.Este ejemplo muestra cómo definir un parámetro llamado "Dept", establecer un valor inicial y definir una condición múltiple if que determina qué logo mostrar.

Lo siguiente es un ejemplo del código que podrías introducir en la sección head de la plantilla:

<!-- TemplateParam name="Dept" type="number" value="1" -->

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

<!-- TemplateBeginMultipleIf -->

<!-- verifica el valor de Dept y muestra la imagen apropiada-->

<!-- TemplateBeginIfClause cond="Dept == 1" --> <img src=".../sales.gif"> <!-- TemplateEndIfClause -->

<!-- TemplateBeginIfClause cond="Dept == 2" --> <img src=".../support.gif"> <!-- TemplateEndIfClause-->

<!-- TemplateBeginIfClause cond="Dept == 3" --> <img src=".../hr.gif"> <!-- TemplateEndIfClause -->

<!-- TemplateBeginIfClause cond="Dept != 3" --> <img src=".../spacer.gif"> <!-- TemplateEndIfClause -->

<!-- TemplateEndMultipleIf -->

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

Temas similares

• Creación de una plantilla de Dreamweaver
• Edición de contenido de un documento basado en plantilla
• Creación de regiones editables en plantillas
• Creación de regiones repetidas en plantillas
• Uso de regiones opcionales en plantillas
• Definición de atributos de etiqueta editables en las plantillas
• Rutas relativas al documento
• Modificación de propiedades de plantilla