Carrusel carousel
Visor de carrusel es un visualizador que muestra un carrusel de imágenes de letreros no ampliables con zonas interactivas o regiones en las que se puede hacer clic. Este visor puede ayudarle a implementar una experiencia de "carrusel de ventas" en la que los usuarios pueden seleccionar un punto interactivo o una región sobre la imagen del titular. Pueden ser redirigidos a una vista rápida o a una página de detalles del producto en el sitio web del cliente. Está diseñado para trabajar en equipos de escritorio y dispositivos móviles.
Tipo de visor 511.
URL de demostración section-c0ad383db6a444979dc7eeb1ec4cf54d
Requisitos del sistema section-b7270cc4290043399681dc504f043609
Consulte Requisitos del sistema.
Uso del Visor de carrusel section-e6c68406ecdc4de781df182bbd8088b4
Visor de carrusel representa un archivo JavaScript principal y un conjunto de archivos de ayuda (una sola inclusión JavaScript con todos los componentes SDK del visor utilizados por este visor, recursos y CSS) descargados por el visor en tiempo de ejecución.
El Visor de carrusel se puede utilizar en modo emergente utilizando una página de HTML lista para la producción proporcionada con visores IS o en modo incrustado donde se integra en la página web de destino mediante una API documentada.
La configuración y el aspecto son similares a los de los otros visores descritos en esta Ayuda. Todo el desollado se logra mediante CSS personalizado.
Ver Referencia de comando común a todos los visores: atributos de configuración y Referencia de comando común a todos los visores: URL
Interacción con el visualizador de carrusel section-642e66ca38cd4032992840ec6c0b0cd2
La navegación por el conjunto de carrusel se realiza mediante un barrido horizontal sobre la vista principal o con dos botones de flecha disponibles en el dispositivo de escritorio. Los puntos del indicador de conjunto muestran la posición actual dentro del conjunto.
El visor puede representar zonas interactivas o regiones en la parte superior de la imagen del titular para indicar el área interactiva del producto.
Al tocar o hacer clic en un punto interactivo o en una región, se déclencheur una acción asociada a él durante la creación. La acción puede redirigirse a una página diferente del sitio web o puede devolver la información del producto a la lógica de la página web, lo que a su vez puede almacenar en déclencheur una vista rápida con contenido del producto relacionado.
El visor es totalmente accesible mediante el teclado.
Consulte Navegación y accesibilidad por teclado.
Incrustación del visor de carrusel section-6bb5d3c502544ad18a58eafe12a13435
Modo emergente
En el modo emergente, el visor se abre en una ventana o pestaña independiente del explorador web. Ocupa todo el área de la ventana del explorador y se ajusta en caso de que cambie el tamaño del explorador o la orientación de un dispositivo móvil.
El modo emergente es el más común en dispositivos móviles. La página web carga el visor mediante la llamada de JavaScript window.open()
, el elemento de HTML A
configurado correctamente o cualquier otro método adecuado.
Se recomienda utilizar una página de HTML predeterminada para el modo de operación emergente. En este caso, se llama CarouselViewer.html
y se encuentra dentro de la subcarpeta html5/
de su implementación estándar de IS-Viewers:
<s7viewers_root>/html5/CarouselViewer.html
Puede conseguir una personalización visual aplicando CSS personalizado.
A continuación se muestra un ejemplo de código de HTML que abre el visor en una nueva ventana:
<a href="https://demos-pub.assetsadobe.com/etc/dam/viewers/s7viewers/html5/CarouselViewer.html?asset=/content/dam/dm-public-facing-live-demo-page/04_shoppable_carousel/05_shoppable_banner&serverurl=https://adobedemo62-h.assetsadobe.com/is/image" target="_blank">Open popup viewer</a>
Acerca del modo de incrustación de tamaño fijo y el modo de incrustación de diseño interactivo
En el modo incrustado, el visor se agrega a la página web existente. Es posible que esta página web ya tenga algunos contenidos de clientes no relacionados con el visor. Normalmente, el visor solo ocupa una parte de los bienes raíces de una página web.
Los casos de uso principales son páginas web orientadas para equipos de escritorio o tabletas, y páginas con diseño interactivo que ajustan el diseño automáticamente según el tipo de dispositivo.
La incrustación de tamaño fijo se utiliza cuando el visor no cambia su tamaño después de la carga inicial. Este método es la mejor opción para las páginas web que tienen un diseño estático.
La incrustación de diseño interactivo supone que el visor debe cambiar de tamaño durante la ejecución en respuesta al cambio de tamaño de su contenedor DIV
. El caso de uso más común es añadir un visor a una página web que utilice un diseño de página flexible.
En el modo de incrustación de diseño interactivo, el visor se comporta de forma diferente según la forma en que la página web ajusta el tamaño de su contenedor DIV
. Si la página web establece únicamente la anchura del contenedor DIV
y no restringe su altura, el visor elige automáticamente su altura en función de la proporción de aspecto del recurso utilizado. Esta funcionalidad garantiza que el recurso se ajuste perfectamente a la vista sin ningún relleno en los lados. Este caso de uso es el más común para páginas web que utilizan marcos de diseño web adaptables como Bootstrap y Foundation.
De lo contrario, si la página web establece tanto la anchura como la altura del contenedor del visor DIV
, solo rellenará esa área. También sigue el tamaño que proporciona el diseño de página web. Un buen ejemplo es la incrustación del visualizador en una superposición modal, donde el tamaño de la superposición depende del tamaño de la ventana del explorador web.
Incrustación de tamaño fijo
Para agregar el visor a una página web, haga lo siguiente:
-
Añadir el archivo de JavaScript del visor a la página web.
-
Definir el contenedor
DIV
. -
Configuración del tamaño del visor.
-
Creación e inicialización del visor.
-
Añadir el archivo de JavaScript del visor a la página web.
La creación de un visor requiere que añada una etiqueta de script en el encabezado del HTML. Antes de usar la API de visor, asegúrese de incluir CarouselViewer.js. El archivo CarouselViewer.js se encuentra en la subcarpeta html5/js/ de su implementación estándar de visores IS:
<s7viewers_root>/etc/dam/viewers/s7viewers/html5/js/CarouselViewer.js
Puede utilizar una ruta relativa si el visor está implementado en uno de los servidores de Adobe Dynamic Media Classic y se proporciona desde el mismo dominio. De lo contrario, especifique una ruta completa a uno de los servidores de Adobe Dynamic Media Classic que tengan instalados los visores de IIS.
La ruta relativa tiene el siguiente aspecto:
<script language="javascript" type="text/javascript" src="/etc/dam/viewers/s7viewers/html5/js/CarouselViewer.js"></script>
include
del visor principal en su página. No haga referencia a ningún archivo JavaScript adicional en el código de la página web que la lógica del visor pueda descargar durante la ejecución. En particular, no haga referencia directamente a la biblioteca Utils.js
del SDK de HTML5 cargada por el visor desde la ruta de contexto /s7viewers
(denominado SDK consolidado include
). El motivo es que la ubicación de Utils.js
o bibliotecas similares del visor en tiempo de ejecución está completamente administrada por la lógica del visor y la ubicación cambia entre versiones del visor. El Adobe no mantiene versiones anteriores del visor secundario includes
en el servidor.include
secundario que use el visor en la página, se interrumpe la funcionalidad del visor en el futuro cuando se implemente una nueva versión del producto.-
Definir el contenedor
DIV
.Agregue un elemento
DIV
vacío a la página donde desea que aparezca el visor. El elementoDIV
debe tener su ID definido, ya que este ID se pasa posteriormente a la API del visor. El DIV tiene su tamaño especificado mediante CSS.El marcador de posición
DIV
es un elemento posicionado, lo que significa que la propiedad CSSposition
está establecida enrelative
oabsolute
.A continuación se muestra un ejemplo de un elemento
DIV
de marcador de posición definido:code language-css <div id="s7viewer" style="position:relative"></div>
-
Configuración del tamaño del visor
Puede establecer el tamaño estático del visor declarándolo para la clase CSS de nivel superior
.s7carouselviewer
en unidades absolutas o utilizando el modificadorstagesize
.Puede poner el tamaño en CSS directamente en la página del HTML. O bien, puede colocar el tamaño en un archivo CSS de visor personalizado, que luego se asigna a un registro de ajuste preestablecido de visor en AEM Assets - Bajo demanda, o se pasa explícitamente mediante el comando
style
.Consulte Personalización del visor de carrusel para obtener más información sobre cómo aplicar estilo al visor con CSS.
A continuación se muestra un ejemplo de definición de un tamaño de visor estático en la página del HTML:
code language-css #s7viewer.s7carouselviewer { width: 1174px; height: 500px; }
Puede pasar explícitamente el modificador
stagesize
con el código de inicialización del visor con la colecciónparams
o como una llamada de API como se describe en la sección Referencia de comandos, de esta manera:code language-css carouselViewer.setParam("stagesize", "1174,500");
Se recomienda un enfoque basado en CSS y se utiliza en este ejemplo.
-
Creación e inicialización del visor.
Cuando haya completado los pasos anteriores, cree una instancia de la clase
s7viewers.CarouselViewer
, pase toda la información de configuración a su constructor y llame al métodoinit()
en una instancia de visor. La información de configuración se pasa al constructor como un objeto JSON. Como mínimo, este objeto debe tener el campocontainerId
que contiene el nombre del ID del contenedor del visor y el objeto JSONparams
anidado con parámetros de configuración admitidos por el visor. En este caso, el objetoparams
debe tener al menos la dirección URL del servicio de imágenes pasada como propiedadserverUrl
y el recurso inicial como parámetroasset
. La API de inicialización basada en JSON permite crear e iniciar el visor con una sola línea de código.Es importante tener el contenedor del visor añadido al DOM para que el código del visor pueda encontrar el elemento contenedor por su ID. Algunos exploradores retrasan la creación de DOM hasta el final de la página web. Para conseguir la máxima compatibilidad, llame al método
init()
justo antes de la etiqueta de cierreBODY
o en el eventoonload()
del cuerpo.Al mismo tiempo, el elemento contenedor no debe formar parte necesariamente del diseño de la página web todavía. Por ejemplo, se puede ocultar usando el estilo
display:none
asignado a él. En este caso, el visor retrasa su proceso de inicialización hasta el momento en que la página web devuelve el elemento contenedor al diseño. Cuando se produce esta funcionalidad, la carga del visor se reanuda automáticamente.A continuación se muestra un ejemplo de cómo crear una instancia de visor, pasar las opciones de configuración mínimas necesarias al constructor y llamar al método
init()
. El ejemplo supone quecarouselViewer
es la instancia del visor;s7viewer
es el nombre del marcador de posiciónDIV
;https://adobedemo62-h.assetsadobe.com/is/image
es la dirección URL del servicio de imágenes y/content/dam/dm-public-facing-live-demo-page/04_shoppable_carousel/05_shoppable_banner
es el recurso:code language-javascript <script type="text/javascript"> var carouselViewer = new s7viewers.CarouselViewer ({ "containerId":"s7viewer", "params":{ "asset":"/content/dam/dm-public-facing-live-demo-page/04_shoppable_carousel/05_shoppable_banner", "serverurl":"https://adobedemo62-h.assetsadobe.com/is/image" } }).init(); </script>
El siguiente código es un ejemplo completo de una página web trivial que incrusta el Visor de carrusel con un tamaño fijo:
code language-html <!DOCTYPE html> <html> <head> <script type="text/javascript" src="https://demos-pub.assetsadobe.com/etc/dam/viewers/s7viewers/html5/js/CarouselViewer.js"></script> <style type="text/css"> #s7viewer.s7carouselviewer { width: 1174px; height: 500px; } </style> </head> <body> <div id="s7viewer" style="position:relative"></div> <script type="text/javascript"> var carouselViewer = new s7viewers.CarouselViewer({ "containerId":"s7viewer", "params":{ "asset":"/content/dam/dm-public-facing-live-demo-page/04_shoppable_carousel/05_shoppable_banner", "serverurl":"https://adobedemo62-h.assetsadobe.com/is/image" } }).init(); </script> </body> </html>
Inserción de diseño interactivo con altura sin restricciones
Con incrustación de diseño interactivo, la página web normalmente tiene algún tipo de diseño flexible que dicta el tamaño de tiempo de ejecución del contenedor del visor DIV
. En el siguiente ejemplo, supongamos que la página web permite que el contenedor del visor DIV
ocupe el 40% del tamaño de la ventana del explorador web. Y, su altura se deja sin restricciones. El código del HTML de la página web tendría el siguiente aspecto:
<!DOCTYPE html>
<html>
<head>
<style type="text/css">
.holder {
width: 80%;
}
</style>
</head>
<body>
<div class="holder"></div>
</body>
</html>
Añadir el visor a una página de este tipo es similar a los pasos para la incrustación de tamaño fijo. La única diferencia es que no es necesario definir explícitamente el tamaño del visor.
- Añadir el archivo de JavaScript del visor a la página web.
- Definir el contenedor
DIV
. - Creación e inicialización del visor.
Todos los pasos anteriores son los mismos que con la incrustación de tamaño fijo. Agregar el contenedor DIV
al "holder"
DIV
existente. El siguiente código es un ejemplo completo. Observe cómo cambia el tamaño del visor cuando se cambia el tamaño del explorador y cómo la proporción de aspecto del visor coincide con el recurso.
<!DOCTYPE html>
<html>
<head>
<script type="text/javascript" src="https://demos-pub.assetsadobe.com/etc/dam/viewers/s7viewers/html5/js/CarouselViewer.js"></script>
<style type="text/css">
.holder {
width: 80%;
}
</style>
</head>
<body>
<div class="holder">
<div id="s7viewer" style="position:relative"></div>
</div>
<script type="text/javascript">
var carouselViewer = new s7viewers.CarouselViewer({
"containerId":"s7viewer",
"params":{
"asset":"/content/dam/dm-public-facing-live-demo-page/04_shoppable_carousel/05_shoppable_banner",
"serverurl":"https://adobedemo62-h.assetsadobe.com/is/image"
}
}).init();
</script>
</body>
</html>
La siguiente página de ejemplos ilustra usos más reales del diseño interactivo incrustado con una altura sin restricciones:
Incrustación de tamaño flexible con anchura y altura definidas
En la incrustación de tamaño flexible con la anchura y la altura definidas, el estilo de la página web es diferente. Proporciona ambos tamaños al DIV "holder"
y lo centra en la ventana del explorador. Además, la página web establece el tamaño del elemento HTML
y BODY
en un 100 por ciento.
<!DOCTYPE html>
<html>
<head>
<style type="text/css">
html, body {
width: 100%;
height: 100%;
}
.holder {
position: absolute;
left: 20%;
top: 20%;
width: 60%;
height: 60%;
}
</style>
</head>
<body>
<div class="holder"></div>
</body>
</html>
El resto de los pasos de incrustación son idénticos a los pasos utilizados para la incrustación adaptable con altura sin restricciones. El ejemplo resultante es el siguiente:
<!DOCTYPE html>
<html>
<head>
<script type="text/javascript" src="https://demos-pub.assetsadobe.com/etc/dam/viewers/s7viewers/html5/js/CarouselViewer.js"></script>
<style type="text/css">
html, body {
width: 100%;
height: 100%;
}
.holder {
position: absolute;
left: 20%;
top: 20%;
width: 60%;
height: 60%;
}
</style>
</head>
<body>
<div class="holder">
<div id="s7viewer" style="position:relative"></div>
</div>
<script type="text/javascript">
var carouselViewer = new s7viewers.CarouselViewer({
"containerId":"s7viewer",
"params":{
"asset":"/content/dam/dm-public-facing-live-demo-page/04_shoppable_carousel/05_shoppable_banner",
"serverurl":"https://adobedemo62-h.assetsadobe.com/is/image"
}
}).init();
</script>
</body>
</html>
Incrustación mediante API basada en el establecedor
En lugar de utilizar la inicialización basada en JSON, es posible utilizar la API basada en establecedores y el constructor sin argumentos. El uso de este constructor de API no toma ningún parámetro y los parámetros de configuración se especifican mediante los métodos de API setContainerId()
, setParam()
y setAsset()
con llamadas de JavaScript independientes.
El siguiente ejemplo ilustra el uso de la incrustación de tamaño fijo con la API basada en establecedores:
<!DOCTYPE html>
<html>
<head>
<script type="text/javascript" src="https://demos-pub.assetsadobe.com/etc/dam/viewers/s7viewers/html5/js/CarouselViewer.js"></script>
<style type="text/css">
#s7viewer.s7carouselviewer {
width: 1174px;
height: 500px;
}
</style>
</head>
<body>
<div id="s7viewer" style="position:relative"></div>
<script type="text/javascript">
var carouselViewer = new s7viewers.CarouselViewer();
carouselViewer.setContainerId("s7viewer");
carouselViewer.setParam("serverurl", "https://adobedemo62-h.assetsadobe.com/is/image");
carouselViewer.setAsset("/content/dam/dm-public-facing-live-demo-page/04_shoppable_carousel/05_shoppable_banner");
carouselViewer.init();
</script>
</body>
</html>