Seleccione Archivo > Nuevo.
Última actualización el
20 dic 2021
Aprenda cómo realizar transformaciones XSL en el lado del servidor en Dreamweaver. Cree páginas XSLT y convierta páginas HTML en XSLT.
La interfaz de usuario se ha simplificado en Dreamweaver y versiones posteriores. Como resultado, es posible que no encuentre algunas de las opciones que se describen en este artículo en Dreamweaver y versiones posteriores. Para obtener más información, consulte este artículo.
Flujo de trabajo para realizar transformaciones XSL del lado del servidor
Puedes realizar transformaciones XSL del lado del servidor.Lea sobre las transformaciones XSL del lado del servidor y del lado del cliente y sobre el uso de XML y XSL con páginas web antes de generar páginas que muestren datos XML.
El servidor debe estar configurado correctamente para realizar transformaciones en el lado del servidor. Para más información, póngase en contacto con el administrador del servidor.
El flujo de trabajo general para realizar transformaciones XSL del lado del servidor es el siguiente (cada paso se describe en otros temas):
1.Configure un sitio de Dreamweaver.
2. Elegir una tecnología de servidor y establecer un servidor de aplicaciones.
3. Probar el servidor de aplicaciones.
Por ejemplo, cree una página que requiera procesamiento y asegúrese de que el servidor de aplicaciones procese la página.
4.Cree un fragmento o página XSLT, o convierta una página HTML a una página XSLT.
En su sitio de Dreamweaver, cree un fragmento XSLT o una página XSLT completa.
Convierta una página HTML existente en una página completa XSLT.
5. Adjuntar una fuente de datos XML a la página.
6. Mostrar datos XML enlazando los datos al fragmento XSLT o a toda la página XSLT.
7. Si corresponde, agregue un objeto XSLT de región repetida a la tabla o fila de tabla que contiene los marcadores de posición de datos XML.
8. Insertar referencias.
Para insertar una referencia al fragmento XSLT en la página dinámica, utilice el comportamiento del servidor Transformación XSL.
Para insertar una referencia a toda la página XSLT en la página dinámica, elimine todo el código HTML de la página dinámica y, a continuación, use el comportamiento del servidor Transformación XSL.
9. Publicar la página y el fragmento.
Publique tanto la página dinámica como el fragmento XSLT (o toda la página XSLT) en su Servidor de aplicación. Si usas un archivo XML local, también necesitarás enviarlo.
10.Visualice la página dinámica en un explorador.
Al hacerlo, el servidor de aplicaciones transforma los datos XML, los inserta en la página dinámica y los muestra en el explorador.
Crear una página XSLT
Puedes crear páginas XSLT que te permitan mostrar datos XML en páginas web.Puede crear una página XSLT completa (una página XSLT que contiene una etiqueta <body> y una etiqueta <head>) o un fragmento XSLT.Cuando crea un fragmento XSLT, crea un archivo independiente que no contiene etiquetas body ni head, un fragmento de código simple que se inserta posteriormente en una página dinámica.
Si utiliza una página XSLT existente como base, deberá adjuntar una fuente de datos XML.
En la categoría Página en blanco del cuadro de diálogo Nuevo documento,
seleccione una de las siguientes opciones de la columna Tipo de página:
Seleccione XSLT (página completa) para crear una página XSLT completa.
Seleccione XSLT (fragmento) para crear un fragmento de XSLT.
Haz clic en Crear y realiza una de las siguientes acciones en el cuadro de diálogo Localizar
fuente XML:
- Seleccione Adjuntar un archivo local en mi equipo o en la red de área local, haga clic en el botón Examinar, busque un archivo XML en su equipo y, por último, haga clic en Aceptar.
- Seleccione Adjuntar un archivo remoto en Internet, escriba el URL de un archivo XML de Internet (por ejemplo, uno proveniente de un agregador RSS) y haga clic en Aceptar.
Si hace clic en el botón Cancelar, se generará una página XSLT nueva sin fuente de datos XML adjunta.
El panel Vinculaciones muestra el esquema de la fuente de datos XML
En la tabla siguiente se incluyen explicaciones de los distintos elementos del esquema que pueden aparecer:
Elemento |
Representa |
Detalles |
|---|---|---|
<> |
Elemento XML no repetido requerido |
Un elemento que aparece exactamente una vez dentro de su nodo padre |
<>+ |
Elemento XML repetido |
Un elemento que aparece una o más veces dentro de su nodo padre |
<>+ |
Elemento XML opcional |
Un elemento que no aparece ninguna vez o más veces dentro de su nodo padre |
Nodo de elemento en negrita |
Elemento de contexto actual |
Normalmente, el elemento repetido cuando el punto de inserción se encuentra dentro de una región repetida |
@ |
Atributo XML |
|
Guarda la nueva página (Archivo > Guardar) con la
extensión .xsl o .xslt (.xsl es la predeterminada).
Conversión de páginas HTML en páginas XSLT
También puedes convertir páginas HTML existentes a páginas XSLT. Por ejemplo, si tienes una página estática prediseñada a la que quieres añadir datos XML, puedes convertir la página a una página XSLT, en lugar de crear una página XSLT y rediseñar la página desde cero.
Abra la página HTML que desea convertir.
Selecciona Archivo > Convertir > XSLT
1.0.
Se abre una copia de la página en la ventana de documento. La nueva página es una hoja de estilos XSL, guardada con la extensión .xsl.
Cómo adjuntar fuentes de datos XML
Si empiezas con una página XSLT existente, o si no adjuntas una fuente de datos XML al crear una nueva página XSLT con Dreamweaver, debes adjuntar una fuente de datos XML usando el panel Vínculos.
En el panel Vínculos (Ventana > Vínculos),
haz clic en el enlace XML.
También puede hacer clic en el vínculo Origen situado en la esquina superior derecha del panel Vinculaciones para añadir una fuente de datos XML.
Siga uno de estos procedimientos:
Selecciona Adjuntar un archivo local, haz clic en el botón Examinar, busca un archivo XML local en tu ordenador y haz clic en Aceptar.
Selecciona Adjuntar un archivo remoto e introduce la URL de un archivo XML en Internet (como uno proveniente de un feed RSS).
Haga clic en Aceptar para cerrar el cuadro de diálogo Buscar origen XML.
El panel Vínculos se completa con el esquema de tu fuente de datos XML.
Visualización de datos XML en páginas XSLT
Después de haber creado una página XSLT y adjuntado una fuente de datos XML, puedes vincular datos a la página. Para hacer esto, añades un marcador de posición de datos XML a tu página y luego usas el Creador de expresiones XPath o el inspector de Propiedades para formatear los datos seleccionados que se mostrarán en la página.
Abra una página XSLT con una fuente de datos XML adjunta.
(Opcional) Selecciona Insertar > Tabla para añadir una
tabla a la página. Las tablas ayudan a organizar los datos XML.
Nota
En la mayoría de los casos, usas el objeto XSLT Región repetida para mostrar elementos XML repetidos en una página. En este caso, podrías querer crear una tabla de una sola fila con una o más columnas, o una tabla de dos filas si quieres incluir un encabezado de tabla.
En el panel Vínculos, selecciona un elemento XML y arrástralo
al lugar de la página donde quieras insertar datos.
Aparece un marcador de posición de datos XML en la página. El marcador de posición se resalta y está entre llaves. Usa la sintaxis XPath (lenguaje de ruta XML) para describir la estructura jerárquica del esquema XML. Por ejemplo, si arrastras el elemento hijo title a la página, y ese elemento tiene los elementos padre rss, channel y item, entonces la sintaxis para el marcador de posición de contenido dinámico será {rss/channel/item/title}.
Haz doble clic en el marcador de posición de datos XML en la página para abrir el Creador de expresiones XPath. El Creador de expresiones XPath te permite formatear datos seleccionados, o seleccionar otros elementos del esquema XML.
(Opcional) Aplica estilos a tus datos XML seleccionando un marcador de posición de datos XML y aplicándole estilos como a cualquier otro contenido mediante el inspector de Propiedades o el panel Estilos CSS.Como alternativa, puede usar hojas de estilo en tiempo de diseño para aplicar estilos a fragmentos XSLT.Cada uno de estos métodos tiene su propio conjunto de
ventajas y limitaciones.
Obtenga una vista previa de su trabajo en un explorador (Archivo > Vista previa
en explorador).
Al obtener una vista previa de su trabajo mediante la opción Vista previa en el navegador, Dreamweaver lleva a cabo una transformación XSL interna sin utilizar ningún servidor de aplicaciones.
Visualización de elementos XML repetidos
El objeto XSLT Región repetida le permite mostrar elementos repetidos de una fuente de datos XML en una página web. Por ejemplo, si está mostrando títulos de artículos y descripciones de una fuente de noticias, y esa fuente de noticias contiene entre 10 y 20 artículos, cada título y descripción en el archivo XML probablemente sería un elemento secundario de un elemento repetido.
Cualquier región en la vista de diseño que contenga un marcador de posición de datos XML se puede cambiar a una región repetida. Sin embargo, las regiones más comunes son tablas, filas de tabla o una serie de filas de tabla.
En la vista de diseño, seleccione una región que contenga
un marcador de posición de datos XML o marcadores de posición.
La selección puede ser cualquier cosa, incluida una tabla, una fila de tabla o incluso un párrafo de texto.
Para seleccionar de forma precisa una región de la página, puede utilizar el selector de etiquetas que se encuentra en la parte inferior de la ventana de documento. Por ejemplo, si la región es una tabla, haga clic dentro de la tabla de la página y, a continuación, haga clic en la etiqueta table del selector de etiquetas.
Siga uno de estos procedimientos:
Seleccione Insertar > Objetos XSLT > Región repetida.
En la categoría XSLT del panel Insertar, haga clic en el botón Región repetida.
En el Generador de expresiones XPath, seleccione el elemento
repetido, indicado por un pequeño signo más.
Haga clic en OK.
En la ventana Documento, aparece un contorno gris delgado con pestañas alrededor de la región repetida. Cuando obtenga una vista previa de su trabajo en un explorador (Archivo > Vista previa en explorador), el contorno gris desaparece y la selección se expande para mostrar los elementos repetidos especificados en el archivo XML.
Cuando agregue el objeto XSLT Región repetida a la página, el marcador de posición de datos XML en la ventana Documento se trunca.Esto se debe a que Dreamweaver trunca el XPath para el marcador de posición de datos XML de modo que sea relativo a la ruta del elemento repetido.
Configuración de las propiedades de Repetir región (XSL)
En el inspector de propiedades, puedes seleccionar un nodo XML diferente para crear la región repetida.
En el cuadro Seleccionar, introduzca un nuevo nodo y, a continuación, presione el icono del rayo y seleccione el nodo del árbol de esquema XML que aparece.
Edición de un objeto XSLT Repetir región
Después de haber agregado un objeto Región repetida XSLT a una región, puede editarlo usando el inspector de propiedades.
Selecciona el objeto haciendo clic en la pestaña gris que rodea la región repetida.
En el inspector de propiedades (Ventana > Propiedades),
haga clic en el icono dinámico junto al campo de texto Seleccionar.
En el Generador de expresiones XPath, haz los cambios y haz clic en Aceptar.
Insertar fragmentos XSLT en páginas dinámicas
Después de haber creado un fragmento XSLT, puede insertarlo en una página web dinámica usando el comportamiento del servidor Transformación XSL. Cuando agregues el comportamiento del servidor a tu página y veas la página en un explorador, un servidor de aplicaciones realiza una transformación que muestra los datos XML del fragmento XSLT seleccionado.Dreamweaver admite transformaciones XSL para páginas ColdFusion, ASP o PHP.
Si quiere insertar el contenido de una página completa XSLT en una página dinámica, el procedimiento es exactamente el mismo. Antes de utilizar el comportamiento de servidor Transformación XSL para insertar la página completa XSLT, elimine todo el código HTML de la página dinámica.
Abra una página de ColdFusion, ASP o PHP existente.
En la vista Diseño, coloca el punto de inserción en la ubicación
donde quieres insertar el fragmento XSLT.
Al insertar fragmentos de XSLT, siempre debe hacer clic en el botón Mostrar vistas de código y diseño después de situar el punto de inserción en la página para poder garantizar que el punto de inserción se encuentra en la ubicación correcta. Si no es así, tal vez deba hacer clic en cualquier otro lugar de la vista de Código para situar el punto de inserción en la ubicación que desee.
En el panel Comportamientos del servidor (Ventana > Comportamientos del servidor), haga clic en el botón Más (+) y seleccione Transformación XSL.
En el cuadro de diálogo Transformación XSL, haz clic en el botón Examinar y busca un fragmento XSLT o una página XSLT completa.
Dreamweaver rellena el siguiente campo de texto con la ruta del archivo o la URL del archivo XML que está adjunto al fragmento especificado. Para cambiarlo, haga clic en el botón Examinar y busque otro archivo.
(Opcional) Haga clic en el botón del signo más (+) para añadir un parámetro XSLT.
Haga clic en Aceptar para insertar una referencia al fragmento XSLT en la página.Este fragmento no se puede editar. Puedes hacer doble clic en el
fragmento para abrir el archivo fuente del fragmento y editarlo.
También se crea una carpeta includes/MM_XSLTransform/ en la carpeta raíz del sitio que contiene un archivo de biblioteca de tiempo de ejecución. El servidor de aplicaciones usa las funciones definidas en este archivo para realizar la transformación.
Carga la página dinámica en tu servidor (Sitio > Poner) y haz clic en Sí para incluir archivos dependientes.El archivo que contiene
el fragmento XSLT, el archivo XML que contiene tus datos y el archivo
de biblioteca de tiempo de ejecución generado deben estar todos en el servidor para que tu página se
muestre correctamente. (Si seleccionaste un archivo XML remoto como fuente de datos,
ese archivo debe residir en algún otro lugar de Internet.)
Eliminar fragmentos XSLT de páginas dinámicas
Puedes eliminar un fragmento XSLT de una página eliminando el comportamiento del servidor Transformación XSL usado para insertar el fragmento. Al eliminar el comportamiento del servidor solo se elimina el fragmento XSLT; no se eliminan los archivos XML, XSLT o de biblioteca de tiempo de ejecución asociados.
En el panel Comportamientos del servidor (Ventana >
Comportamientos del servidor), selecciona el comportamiento del servidor Transformación XSL
que quieres eliminar.
Haga clic en el botón del signo menos (-).
Debe eliminar siempre los comportamientos del servidor de esta forma. La eliminación manual del código generado únicamente quita el comportamiento del servidor de forma parcial, incluso si el comportamiento del servidor desaparece del panel Comportamientos del servidor.
Editar comportamientos del servidor de transformación XSL
Después de haber añadido un fragmento XSLT a una página web dinámica, puedes editar el comportamiento del servidor de transformación XSL en cualquier momento.
En el panel Comportamientos del servidor (Ventana > Comportamientos del servidor), haz doble clic en el comportamiento del servidor Transformación XSL que deseas editar.
Realice los cambios que desee y haga clic en Aceptar.
Creación de un vínculo dinámico
Puedes crear un enlace dinámico en tu página XSLT que enlace a una URL específica cuando el usuario haga clic en una palabra especificada o grupo de palabras de tus datos XML. Para obtener instrucciones completas, consulta las erratas de Dreamweaver en www.adobe.com/go/dw_documentation.
Aplicación de estilos a fragmentos de XSLT
Cuando creas una página XSLT completa (es decir, una página XSLT que contiene etiquetas <body> y <head>), puedes mostrar datos XML en la página y luego formatear los datos como cualquier otro contenido usando el inspector de Propiedades o el panel Estilos CSS. Sin embargo, cuando creas un fragmento XSLT para inserción en una página dinámica (por ejemplo, un fragmento para inserción en una página ASP, PHP o Cold Fusion), el renderizado de estilos en el fragmento y en la página dinámica se vuelve más complicado. Aunque trabajas en un fragmento XSLT por separado de la página dinámica, es importante recordar que el fragmento está destinado para uso dentro de la página dinámica, y que la salida del fragmento XSLT finalmente reside en algún lugar dentro de las etiquetas <body> de la página dinámica. Dado este flujo de trabajo, es importante asegurar que no incluyas elementos <head> (como definiciones de estilo o vínculos a hojas de estilo externas) en fragmentos XSLT.Si lo haces, el servidor de la aplicación colocará estos elementos en el <body> de la página dinámica, generando así marcado no válido.
Por ejemplo, es posible que quieras crear un fragmento XSLT para insertarlo en una página dinámica y dar formato al fragmento usando la misma hoja de estilo externa que la página dinámica. Si adjuntas la misma hoja de estilo al fragmento, la página HTML resultante contiene un vínculo duplicado a la hoja de estilo (uno en la sección <head> de la página dinámica, y otro en la sección <body> de la página, donde aparece el contenido del fragmento XSLT). En lugar de este enfoque, debes usar hojas de estilo de tiempo de diseño para hacer referencia a la hoja de estilo externa.
Al dar formato al contenido de fragmentos XSLT, usa el siguiente flujo de trabajo:
En primer lugar, adjunte una hoja de estilos externa a la página dinámica. (Esta es la práctica recomendada para aplicar estilos al contenido de cualquier página Web).
A continuación, adjunte la misma hoja de estilos externa al fragmento de XSLT como una hoja de estilos de tiempo de diseño. Tal como indica su propio nombre, las hojas de estilos de tiempo de diseño solo funcionan en la Vista de diseño de Dreamweaver.
Una vez finalizados los dos pasos anteriores, puede crear nuevos estilos en el fragmento de XSLT con la misma hoja de estilos que adjuntó a la página dinámica. El código HTML resultante será más claro (ya que la referencia a la hoja de estilos solo es válida mientras se trabaja en Dreamweaver) y el fragmento seguirá mostrando los estilos adecuados en la Vista de diseño. Además, todos los estilos se aplicarán tanto al fragmento como a la página dinámica cuando la visualice en la vista de Diseño, o cuando obtenga una vista previa de la página dinámica en un navegador.
Si obtiene una vista previa del fragmento de XSLT en un navegador, éste no mostrará los estilos. Deberá obtener la vista previa de la página dinámica en el navegador para poder visualizar el fragmento de XSLT en el contexto de la página dinámica.
Utilización de los parámetros en las transformaciones XSL
Puedes definir parámetros para tu transformación XSL al añadir el comportamiento del servidor XSL Transformation a una página web. Un parámetro controla cómo se procesan y muestran los datos XML. Por ejemplo, podrías usar un parámetro para identificar y enumerar un artículo específico de una fuente de noticias.Cuando la página se carga en un explorador, solo aparece el artículo que especificaste con el parámetro.
Añadir un parámetro XSLT a una transformación XSL
Abra el cuadro de diálogo Transformación XSL.
Puedes hacer esto haciendo doble clic en un comportamiento del servidor XSL Transformation
en el panel Comportamientos del servidor (Ventana > Comportamientos del
servidor), o añadiendo un nuevo comportamiento del servidor XSL Transformation.
En el cuadro de diálogo XSL Transformation, haz clic en el botón Más (+) junto a Parámetros XSLT.
En el cuadro de diálogo Añadir parámetros, introduce un nombre para el
parámetro en el cuadro Nombre. El nombre solo puede contener caracteres
alfanuméricos. No puede contener espacios.
Siga uno de estos procedimientos:
Si quieres usar un valor estático, introdúcelo en el cuadro Valor.
Si quieres usar un valor dinámico, haz clic en el icono dinámico junto al cuadro Valor, completa el diálogo Datos dinámicos y haz clic en Aceptar.Para más información, haz clic en el botón Ayuda del cuadro de diálogo Datos dinámicos.
En el cuadro Valor predeterminado, introduce el valor que quieres que
use el parámetro si la página no recibe ningún valor de tiempo de ejecución, y haz clic
en Aceptar.
Edición de un parámetro XSLT
Abra el cuadro de diálogo Transformación XSL.
Puedes hacer esto haciendo doble clic en un comportamiento del servidor XSL Transformation
en el panel Comportamientos del servidor (Ventana > Comportamientos del
servidor), o añadiendo un nuevo comportamiento del servidor XSL Transformation.
Seleccione un parámetro en la lista de parámetros XSLT.
Haga clic en el botón Editar.
Realice los cambios que desee y haga clic en Aceptar.
Eliminación de un parámetro XSLT
Abra el cuadro de diálogo Transformación XSL.
Puedes hacer esto haciendo doble clic en un comportamiento del servidor XSL Transformation
en el panel Comportamientos del servidor (Ventana > Comportamientos del
servidor), o añadiendo un nuevo comportamiento del servidor XSL Transformation.
Seleccione un parámetro en la lista de parámetros XSLT.
Haga clic en el botón del signo menos (-).
Crear y editar regiones XSLT condicionales
Puedes crear regiones condicionales simples o múltiples regiones condicionales en una página XSLT. Puedes seleccionar un elemento en la vista Diseño y aplicar una región condicional a la selección, o puedes insertar una región condicional dondequiera que esté el punto de inserción en el documento.
Por ejemplo, si quieres mostrar la palabra "No disponible" junto al precio de un artículo cuando el artículo no está disponible, escribes el texto "No disponible" en la página, lo seleccionas y luego aplicas una región condicional al texto seleccionado.Dreamweaver rodea la selección con etiquetas <xsl:if> y solo muestra la palabra «No disponible» en la página cuando los datos cumplen las condiciones de la expresión condicional.
Aplicación de una región condicional XSLT
Puedes escribir una expresión condicional simple para insertar en tu página XSLT. Si hay contenido seleccionado cuando abres el cuadro de diálogo Región condicional, el contenido se envolverá en un bloque <xsl:if>.Si no hay contenido seleccionado, el bloque <xsl:if> se añade en el punto de inserción de la página. Es recomendable usar el cuadro de diálogo para empezar y después personalizar la expresión en la vista Código.
El elemento <xsl:if> es similar a la declaración if en otros lenguajes. El elemento proporciona una forma de probar una condición y tomar un curso de acción basado en el resultado. El elemento <xsl:if> te permite probar una expresión para un solo valor verdadero o falso.
Selecciona Insertar > Objetos XSLT >
Región condicional o haz clic en el icono Región condicional en la categoría XLST
del panel Insertar.
En el cuadro de diálogo Región condicional, introduce la expresión condicional
a usar para la región.
En el siguiente ejemplo, quieres probar para ver si el valor del atributo @available del nodo de contexto es true.
Haga clic en Aceptar.
El código siguiente se inserta en la página XSLT:
<xsl:if test="@available='true'">
Colocar aquí el contenido
</xsl:if>
Debe rodear los valores de cadena, como los valores true, entre comillas. Dreamweaver codifica automáticamente las comillas por ti (') para que se introduzcan como XHTML válido.
Además de probar si los nodos tienen valores, puedes usar cualquiera de las funciones XSLT compatibles en cualquier declaración condicional.La condición se prueba para el nodo actual del archivo XML. En el siguiente ejemplo, quieres probar para el último nodo en el conjunto de resultados:
Para más información y ejemplos sobre escribir expresiones condicionales, ve la sección <xsl:if> en el panel Referencia (Ayuda > Referencia).
Aplicar múltiples regiones XSLT condicionales
Puedes escribir una expresión condicional simple para insertar en tu página XSLT. Si hay contenido seleccionado cuando abres el cuadro de diálogo Región condicional, el contenido se ajusta en un bloque <xsl:choose>. Si no seleccionas contenido, el bloque <xsl:choose> se añade en el punto de inserción de la página. Es recomendable usar el cuadro de diálogo para empezar y después personalizar la expresión en la vista Código.
El elemento <xsl:choose> es similar a la declaración case en otros lenguajes. El elemento proporciona una forma de comprobar una condición y realizar una acción basada en el resultado.El elemento <xsl:choose> te permite probar múltiples condiciones.
Selecciona Insertar > Objetos XSLT >
Región condicional múltiple o haz clic en el icono Región condicional múltiple
en la categoría XLST del panel Insertar.
En el cuadro de diálogo Región condicional múltiple, introduce
la primera condición.
En el siguiente ejemplo, quieres comprobar si el subelemento price del nodo de contexto es menor que 5.
Haga clic en OK.
En el ejemplo, el siguiente código se inserta en tu página XSLT:
<xsl:choose>
<xsl:when test="price<5">
Colocar aquí el contenido
</xsl:when>
<xsl:otherwise>
Colocar aquí el contenido
</xsl:otherwise>
</xsl:choose>
Para insertar otra condición, coloca el punto de inserción
en la vista Código entre los pares de etiquetas <xsl:when>
o justo antes de la etiqueta <xsl:otherwise>, y
luego inserta una región condicional (Insertar > Objetos XSLT >
Región condicional).
Después de especificar la condición y hacer clic en Aceptar, se inserta otra etiqueta <xsl:when> en el bloque <xsl:choose>.
Para obtener más información y ejemplos sobre cómo escribir expresiones condicionales, consulta las secciones <xsl:choose> en el panel de referencia (Ayuda > Referencia).
Configuración de las propiedades de región condicional (If)
El propósito del inspector de propiedades Establecer región condicional es cambiar la condición utilizada en una región condicional en tu página XSL. La región condicional comprueba la condición y toma un curso de acción basado en el resultado.
En el cuadro Prueba, introduce una nueva condición y luego
presiona Intro.
Configuración de las propiedades condicionales (When)
El propósito del inspector de propiedades Establecer región condicional es cambiar la condición utilizada en una región condicional múltiple en tu página XSL. La región condicional múltiple comprueba la condición y toma un curso de acción basado en el resultado.
En el cuadro Prueba, introduce una nueva condición y luego
presiona Intro.
Inserción de comentarios XSL
Puedes añadir etiquetas de comentario XSL a un documento, o puedes envolver una selección en etiquetas de comentario XSL.
Adición de etiquetas de comentarios XSL a un documento
Siga uno de estos procedimientos:
En la vista Diseño, selecciona Insertar > Objetos XSLT > Comentario XSL, escribe el contenido del comentario (o deja el cuadro vacío) y haz clic en Aceptar.
En la vista Código, selecciona Insertar > Objetos XSLT > Comentario XSL.
Nota
También puedes hacer clic en el icono Comentario XSL en la categoría XSLT del panel Insertar.
Envolver una selección en etiquetas de comentario XSL
Cambia a la vista Código (Ver > Código).
Seleccione el código que quiere comentar.
En la barra de herramientas Coding, haga clic en el botón Apply Comment
y seleccione Apply <xsl:comment></xsl:comment> Comment.
Usar XPath Expression Builder para añadir expresiones para datos XML
XPath (XML Path Language) es una sintaxis no XML para hacer referencia a partes de un documento XML.Se usa principalmente como un lenguaje de consulta para datos XML, igual que el lenguaje SQL se usa para consultar bases de datos. Para obtener más información sobre XPath, consulte la especificación del lenguaje XPath en el sitio web de W3C en www.w3.org/TR/xpath.
XPath Expression Builder es una función de Dreamweaver que te permite crear expresiones XPath simples para identificar nodos específicos de datos y para áreas repetitivas. La ventaja de usar este método en lugar de arrastrar valores desde el árbol de esquema XML es que puedes formatear el valor que se muestra. El contexto actual se identifica según la posición del punto de inserción en el archivo XSL cuando se abre el cuadro de diálogo XPath Expression Builder. El contexto actual se muestra en negrita en el árbol del esquema XML. A medida que haces selecciones en este cuadro de diálogo, se generan las declaraciones XPath correctas, relativas a tu contexto actual. Esto simplifica el proceso de escribir expresiones XPath correctas para principiantes y usuarios avanzados.
Esta función está diseñada para ayudarle a crear expresiones XPath simples que identifiquen un nodo concreto o regiones repetidas. No da la posibilidad de editar las expresiones manualmente. Si necesita crear expresiones más complejas, utilice el cuadro de diálogo Creador de expresiones XPath para empezar y, después, personalice las expresiones en la vista de Código o en el inspector de propiedades.
Crear una expresión XPath para identificar un nodo específico
Haz doble clic en el marcador de posición de datos XML
en la página para abrir XPath Expression Builder.
En el cuadro de diálogo XPath Expression Builder (Dynamic Text),
selecciona cualquier nodo en el árbol de esquema XML.
La expresión XPath correcta se escribe en el cuadro Expression para identificar el nodo.
Nota
Si seleccionas un nodo diferente en el árbol de esquema XML, la expresión cambia para reflejar tu elección.
En el siguiente ejemplo, quieres mostrar el subelemento price del nodo item:
Esta selección insertaría el siguiente código en tu página XSLT:
<xsl:value-of select="price"/>
(Opcional) Selecciona una opción de formato desde el menú
emergente Format.
Formatear una selección es útil cuando el valor de tu nodo devuelve un número. Dreamweaver proporciona una lista predefinida de funciones de formato. Para obtener una lista completa de funciones de formato disponibles y ejemplos, consulta el panel Reference.
En el siguiente ejemplo, quieres formatear el subelemento price como una moneda con dos decimales:
Estas opciones insertarían el siguiente código en tu página XSLT:<xsl:value-of select="format-number(provider/store/items/item/price,'$#.00')"/>
Haga clic en OK.
Para mostrar el valor de cada nodo en el archivo XML, aplica
una región repetitiva al elemento que contiene el texto dinámico (por
ejemplo, una fila de tabla HTML o un párrafo).
Para obtener más información y ejemplos sobre la selección de nodos para devolver un valor, consulta la sección <xsl:value-of/> en el panel Referencias.
Selección de un nodo para repetir
Puedes seleccionar un nodo para repetir y, opcionalmente, para filtrar los resultados. En el cuadro de diálogo Generador de expresiones XPath, el contenido seleccionado se ajustará dentro de un bloque <xsl:for-each>. Si no has seleccionado contenido, el bloque <xsl:for-each> se introducirá en el punto de inserción del cursor.
Haz doble clic en el marcador de posición de datos XML de la página
para abrir el Generador de expresiones XPath.
En el cuadro de diálogo Generador de expresiones XPath (Región repetitiva),
selecciona el elemento que se repetirá en el árbol de esquemas XML.
La expresión XPath correcta se escribe en el cuadro Expresión para identificar el nodo.
Nota
Los elementos repetitivos se identifican con un símbolo más (+) en el árbol de esquemas XML.
En el siguiente ejemplo, quieres repetir cada nodo item dentro del archivo XML.
Cuando haces clic en Aceptar, se inserta el siguiente código en la página XSLT:
<xsl:for-each select="provider/store/items/item">
Colocar aquí el contenido
</xsl:for-each>
En algunos casos, es posible que quieras trabajar con un subconjunto de los nodos repetitivos; por ejemplo, es posible que solo quieras elementos donde un atributo tenga un valor específico. En este caso, necesitas crear un filtro.
Filtro de los datos que desea repetir
Usa un filtro para identificar nodos repetitivos que tengan valores de atributo específicos.
En el árbol del esquema XML, seleccione un nodo para repetir.
Haga clic en el botón de expansión de creación del filtro.
Haga clic en el botón de signo más (+) para crear un filtro vacío.
Introduzca los criterios del filtro en los siguientes campos:
Filtrar por
Especifica el nodo repetitivo que contiene los datos por los que deseas filtrar.El menú emergente proporciona una lista de nodos ancestros relativos al nodo que seleccionaste en el árbol de esquemas XML.
Dónde
Especifica el atributo o subelemento del nodo Filtrar por que se usará para limitar los resultados. Puedes seleccionar un atributo o subelemento del menú emergente, o puedes introducir tu propia expresión XPath en este campo para identificar elementos secundarios que existen más profundamente dentro del árbol de esquemas.
Operador
Especifica el operador de comparación que se usará en la expresión del filtro.
Valor
Especifica el valor que se debe comprobar en el nodo Filtrar por. Introduzca el valor. Si se definen parámetros dinámicos para la página XSLT, puedes seleccionar uno del menú emergente.
Para especificar otro filtro, haz clic en el botón Más (+) de nuevo.
A medida que introduces valores o realizas selecciones en los menús emergentes, la expresión XPath del cuadro Expresión cambia.
En el siguiente ejemplo, quieres restringir el conjunto de resultados a aquellos nodos item donde el valor del atributo @available sea true.
Al hacer clic en Aceptar, se inserta el siguiente código en la página XSLT:<xsl:for-each select="provider/store/items/item[@available = 'true']"> El contenido va aquí </xsl:for-each>
Debe rodear los valores de cadena como valores true entre comillas. Dreamweaver codifica las comillas automáticamente (') para que se introduzcan como XHTML válido.
Puedes crear filtros más complejos que te permitan especificar nodos principales como parte de tus criterios de filtro.En el siguiente ejemplo, quieres restringir el conjunto de resultados a aquellos nodos item donde el atributo @id de store sea igual a 1 y el nodo price de item sea mayor que 5.
Cuando hagas clic en Aceptar, se inserta el siguiente código en tu página XSLT:<xsl:for-each select="provider/store[@id = 1]/items/item[price > 5]"> El contenido va aquí </xsl:for-each>
Para obtener más información y ejemplos de regiones repetidas, consulta la sección <xsl:for-each> en el panel Referencia.
Temas similares
- Trabajar con sitios de Dreamweaver
- Elegir un servidor de aplicaciones
- Usar XML y XSL con páginas web
- Transformaciones XSL en el lado del cliente
- Transformaciones XSL en el lado del servidor
- Vista previa de datos XML
- Presentación de contenido en tablas
- Datos XML y elementos repetidos
- Uso de hojas de estilos de tiempo de diseño
Crear sitios web atractivos en Dreamweaver
Diseña, codifica y gestiona sitios web dinámicos en una potente herramienta todo en uno.
