Catálogo electrónico ecatalog
eCatalog Viewer es un visor de catálogos que muestra folletos electrónicos en un pliego por pliego o página por página. El catálogo electrónico permite a los usuarios navegar por el catálogo utilizando elementos de interfaz de usuario adicionales o el modo de miniaturas dedicadas. Los usuarios también pueden ampliar cada página para obtener más información.
Tipo de visor 507.
Consulte Requisitos y requisitos previos del sistema.
Este visor funciona con catálogos electrónicos y admite mapas de imágenes opcionales y herramientas de uso compartido en medios sociales. Tiene herramientas de zoom, herramientas de navegación de catálogo, soporte para pantalla completa, miniaturas y un botón de cierre opcional. El visor también admite herramientas de uso compartido en redes sociales, Imprimir, Descargar y Favoritos. Está diseñado para trabajar en equipos de escritorio y dispositivos móviles.
URL de demostración section-e1c3106f5b3e445d9b95be337c2f94e2
https://s7d1.scene7.com/s7viewers/html5/eCatalogViewer.html?asset=Viewers/Pluralist
Uso del visor de catálogos electrónicos section-e6c68406ecdc4de781df182bbd8088b4
eCatalog Viewer representa un archivo JavaScript principal y un conjunto de archivos de ayuda (una sola inclusión JavaScript con todos los componentes del SDK del visor utilizados por este visor, recursos, CSS) descargados por el visor en tiempo de ejecución
Puede utilizar eCatalog Viewer en el modo emergente mediante una página de HTML lista para la producción proporcionada con IS-Viewers o en el modo incrustado, donde se integra en la página web de destino mediante la API documentada.
La configuración y el desollado son similares a los de otros visores. Todo el desollado se logra mediante CSS personalizado.
Consulte Referencia de comando común a todos los visores: atributos de configuración y Referencia de comando común a todos los visores: URL
Interactuar con el visor de catálogos electrónicos section-642e66ca38cd4032992840ec6c0b0cd2
El visor de catálogos electrónicos admite los siguientes gestos táctiles, que son comunes en otras aplicaciones móviles.
Cuando la imagen está en estado de restablecimiento, realiza un desplazamiento de página nativa.
Cuando las miniaturas están activas, se desplaza por la lista de miniaturas.
Es posible activar un efecto de animación realista de voltear la página para navegar entre páginas del catálogo. En estos casos, un usuario puede mantener y arrastrar una esquina de página y voltear la página.
Este visor también admite la entrada táctil y la entrada del ratón en dispositivos Windows con una pantalla táctil y un ratón. Sin embargo, esta compatibilidad se limita únicamente a los exploradores web Chrome, Internet Explorer 11 y Edge.
Este visor es totalmente accesible mediante el teclado, tal como se describe en Navegación y accesibilidad del teclado.
Herramientas de uso compartido de medios sociales con eCatalog Viewer section-eb575084a99647c3a9591f439f40b412
El visor de catálogos electrónicos admite herramientas de uso compartido en redes sociales. Están disponibles como un botón en la barra de control principal que se expande a una barra de herramientas para compartir cuando un usuario hace clic o toca en ella.
La barra de herramientas de uso compartido contiene iconos para cada tipo de canal de uso compartido admitido, que incluye Facebook, Twitter, recurso compartido de correo electrónico, código compartido incrustado y recurso compartido de vínculos. Cuando se activan las herramientas de uso compartido de correo electrónico, de incrustación de recursos compartidos o de vínculo compartido, el visor muestra un cuadro de diálogo modal con el formulario de entrada de datos correspondiente. Cuando se llama a Facebook o a un Twitter, el visor redirige al usuario a un cuadro de diálogo de uso compartido estándar desde un servicio social. Las herramientas de uso compartido no están disponibles en el modo de pantalla completa debido a las restricciones de seguridad del explorador web.
Incrustación del visor de catálogos electrónicos section-6bb5d3c502544ad18a58eafe12a13435
Las distintas páginas web tienen diferentes necesidades de comportamiento del visualizador. A veces, una página web proporciona un vínculo que, cuando se selecciona, abre el visor en una ventana independiente del explorador. En otros casos, es necesario incrustar el derecho de visor en la página de alojamiento. En este último caso, la página web puede tener un diseño de página estático o utilizar un diseño interactivo que se muestre de forma diferente en diferentes dispositivos o para diferentes tamaños de ventana del explorador. Para satisfacer estas necesidades, el visor admite tres modos de funcionamiento principales: emergente, incrustación de tamaño fijo e incrustación de diseño interactivo.
Acerca del 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 window.open()
Llamada de JavaScript, correctamente configurada A
elemento HTML 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 eCatalogViewer.html y se encuentra dentro de html5/ de la implementación estándar de IS-Viewers:
<s7viewers_root>/html5/eCatalogViewer.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://s7d1.scene7.com/s7viewers/html5/eCatalogViewer.html?asset=Viewers/Pluralist" 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 añade a la página web existente, que puede tener ya contenido de clientes no relacionado 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 también páginas diseñadas interactivas 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 visualizador 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
Sin embargo, y sin restricciones de altura, el visualizador elige automáticamente su altura según la relació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 adaptables como Bootstrap y Foundation.
En caso contrario, si la página web establece tanto la anchura como la altura del contenedor del visor DIV
, el visor rellena solo esa área y 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 JavaScript del visor a la página web.
-
Definición del DIV de contenedor.
-
Configuración del tamaño del visor.
-
Creación e inicialización del visor.
-
Añadir el archivo 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 lo siguiente eCatalogViewer.js. El eCatalogViewer.js El archivo se encuentra en html5/js/ de la implementación estándar de IS-Viewers:
<s7viewers_root>/html5/js/eCatalogViewer.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="/s7viewers/html5/js/eCatalogViewer.js"></script>
include
en la 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 concreto, no haga referencia directamente al SDK de HTML5 Utils.js
biblioteca cargada por el visor desde /s7viewers
ruta de contexto (denominado SDK consolidado) include
). El motivo es que la ubicación de Utils.js
Para bibliotecas de visualizadores en tiempo de ejecución similares, la lógica del visualizador las gestiona completamente y la ubicación cambia entre versiones del visualizador. El Adobe no mantiene las versiones anteriores del visor secundario includes
en el servidor.include
que el usuario utiliza en la página interrumpe la funcionalidad del usuario en el futuro cuando se implemente una nueva versión del producto.-
Definición del DIV de contenedor.
Añada un elemento DIV vacío a la página donde desea que aparezca el visor. El elemento DIV debe tener su ID definido, ya que este ID se pasa posteriormente a la API del visor.
El DIV de marcador de posición es un elemento posicionado, lo que significa que la variable
position
La propiedad CSS se establece enrelative
oabsolute
.A continuación se muestra un ejemplo de un elemento DIV de marcador de posición definido:
code language-html <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
.s7ecatalogviewer
clase CSS de nivel superior en unidades absolutas o utilizandostagesize
modificador.Puede poner el tamaño en CSS directamente en la página del HTML. O bien, coloque el tamaño en un archivo CSS de visor personalizado, que luego se asignará a un registro de ajuste preestablecido de visor en Dynamic Media Classic, o bien se pasará explícitamente mediante un comando de estilo.
Consulte Personalizar el visor de catálogos electrónicos 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 una página de HTML:
code language-html #s7viewer.s7ecatalogviewer { width: 640px; height: 480px; }
Puede configurar las variables
stagesize
en el registro de ajustes preestablecidos de visor en Dynamic Media Classic. O bien, puede pasarlo explícitamente con el código de inicialización del visor conparams
o como una llamada API como se describe en la sección Referencia de comandos, como se muestra a continuación:code language-html eCatalogViewer.setParam("stagesize", "640,480");
-
Inicializando el visor.
Cuando haya completado los pasos anteriores, cree una instancia de
s7viewers.eCatalogViewer
, pase toda la información de configuración a su constructor y llame ainit()
en una instancia de visor. La información de configuración se pasa al constructor como un objeto JSON. Como mínimo, este objeto tiene elcontainerId
campo que contiene el nombre del ID de contenedor del visor y el valor anidadoparams
Objeto JSON con parámetros de configuración admitidos por el visor. En este caso, la variableparams
el objeto debe tener al menos la URL del servicio de imágenes pasada comoserverUrl
y el recurso inicial comoasset
parámetro. 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. Sin embargo, para conseguir la máxima compatibilidad, llame al método
init()
método justo antes del cierreBODY
o en el cuerpoonload()
evento.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
display:none
estilo 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 acción, 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 a
init()
método. El ejemplo suponeeCatalogViewer
es la instancia del visualizador;s7viewer
es el nombre del marcador de posiciónDIV
;https://s7d1.scene7.com/is/image/
es la URL del servicio de imágenes yViewers/Pluralist
es el recurso:code language-html <script type="text/javascript"> var eCatalogViewer = new s7viewers.eCatalogViewer({ "containerId":"s7viewer", "params":{ "asset":"Viewers/Pluralist", "serverurl":"https://s7d1.scene7.com/is/image/" } }).init(); </script>
El siguiente código es un ejemplo completo de una página web trivial que incrusta el visor de catálogos electrónicos con un tamaño fijo:
code language-html <!DOCTYPE html> <html> <head> <script type="text/javascript" src="https://s7d1.scene7.com/s7viewers/html5/js/eCatalogViewer.js"></script> <style type="text/css"> #s7viewer.s7ecatalogviewer { width: 640px; height: 480px; } </style> </head> <body> <div id="s7viewer" style="position:relative"></div> <script type="text/javascript"> var eCatalogViewer = new s7viewers.eCatalogViewer({ "containerId":"s7viewer", "params":{ "asset":"Viewers/Pluralist", "serverurl":"https://s7d1.scene7.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 visualizador DIV
. A efectos de este ejemplo, supongamos que la página web permite el contenedor del visor DIV
para ocupar el 40 % del tamaño de la ventana del explorador web, sin restringir su altura. El código de HTML de página web resultante tiene el siguiente aspecto:
<!DOCTYPE html>
<html>
<head>
<style type="text/css">
.holder {
width: 40%;
}
</style>
</head>
<body>
<div class="holder"></div>
</body>
</html>
Añadir el visor a una página de este tipo es similar a la incrustación de tamaño fijo, con la única diferencia de que no es necesario definir explícitamente el tamaño del visor.
- Añadir el archivo JavaScript del visor a la página web.
- Definición del DIV de contenedor.
- Creación e inicialización del visor.
Todos los pasos anteriores son los mismos que con la incrustación de tamaño fijo. Añadir el contenedor DIV
al "titular" existente DIV
. El siguiente código es un ejemplo completo. Puede ver cómo cambia el tamaño del visor cuando se cambia el tamaño del explorador y cómo coincide la proporción de aspecto del visor con el recurso.
<!DOCTYPE html>
<html>
<head>
<script type="text/javascript" src="https://s7d1.scene7.com/s7viewers/html5/js/eCatalogViewer.js"></script>
<style type="text/css">
.holder {
width: 40%;
}
</style>
</head>
<body>
<div class="holder">
<div id="s7viewer" style="position:relative"></div>
</div>
<script type="text/javascript">
var eCatalogViewer = new s7viewers.eCatalogViewer({
"containerId":"s7viewer",
"params":{
"asset":"Viewers/Pluralist",
"serverurl":"https://s7d1.scene7.com/is/image/"
}
}).init();
</script>
</body>
</html>
La siguiente página de ejemplos ilustra casos de uso más reales de incrustación de diseño interactivo con 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. Es decir, proporciona ambos tamaños al "titular" DIV
y lo centra en la ventana del explorador. Además, la página web establece el tamaño del HTML
y BODY
Elemento a 100%:
<!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>
Los pasos de incrustación restantes son idénticos a la incrustación de diseño interactivo con altura sin restricciones. El ejemplo resultante es el siguiente:
<!DOCTYPE html>
<html>
<head>
<script type="text/javascript" src="https://s7d1.scene7.com/s7viewers/html5/js/eCatalogViewer.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 eCatalogViewer = new s7viewers.eCatalogViewer({
"containerId":"s7viewer",
"params":{
"asset":"Viewers/Pluralist",
"serverurl":"https://s7d1.scene7.com/is/image/"
}
}).init();
</script>
</body>
</html>
Incrustación mediante una 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. Con ese constructor de API no toma ningún parámetro y los parámetros de configuración se especifican utilizando setContainerId()
, setParam()
, y setAsset()
Métodos de API con llamadas de JavaScript independientes.
El siguiente ejemplo muestra la incrustación de tamaño fijo con la API basada en establecedores:
<!DOCTYPE html>
<html>
<head>
<script type="text/javascript" src="https://s7d1.scene7.com/s7viewers/html5/js/eCatalogViewer.js"></script>
<style type="text/css">
#s7viewer.s7ecatalogviewer {
width: 640px;
height: 480px;
}
</style>
</head>
<body>
<div id="s7viewer" style="position:relative"></div>
<script type="text/javascript">
var eCatalogViewer = new s7viewers.eCatalogViewer();
eCatalogViewer.setContainerId("s7viewer");
eCatalogViewer.setParam("serverurl", "https://s7d1.scene7.com/is/image/");
eCatalogViewer.setAsset("Viewers/Pluralist");
eCatalogViewer.init();
</script>
</body>
</html>