Personalizar visor de zoom en línea

Toda la personalización visual y la mayoría de las personalizaciones de comportamiento se realizan creando un CSS personalizado.

El flujo de trabajo sugerido es tomar el archivo CSS predeterminado para el visor apropiado, copiarlo en una ubicación diferente, personalizarlo y especificar la ubicación del archivo personalizado en la style= comando.

Los archivos CSS predeterminados se encuentran en la siguiente ubicación:

<s7_viewers_root>/html5/InlineZoomViewer.css

El archivo CSS personalizado debe contener las mismas declaraciones de clase que la predeterminada. Si se omite una declaración de clase, el visor no funciona correctamente porque no proporciona estilos predeterminados integrados para los elementos de la interfaz de usuario.

Además, es importante conservar la siguiente declaración CSS del visor CSS predeterminado, ya que es necesaria para la funcionalidad de zoom en línea:

.s7flyoutviewer .s7flyoutzoomview .s7flyoutzoom {
 width: 100%;
 height: 100%;
 left: 0;
 top: 0;
 border: none;
 z-index:999;
}

Una forma alternativa de proporcionar reglas CSS personalizadas es utilizar estilos incrustados directamente en la página web o en una de las reglas CSS externas vinculadas.

Cuando cree CSS personalizado, tenga en cuenta que el visor asigna .s7flyoutviewer a su elemento DOM contenedor. Si utiliza un archivo CSS externo transferido con style= comando, use .s7flyoutviewer como clase principal en el selector descendente de las reglas CSS. Si está utilizando estilos incrustados en la página web, clasifique también este selector con un ID del elemento DOM contenedor de la siguiente manera:

#<containerId>.s7flyoutviewer

Creación de CSS diseñado interactivo

Es posible segmentar diferentes dispositivos y tamaños de incrustación en CSS para que el contenido se muestre de forma diferente, según el dispositivo del usuario o el diseño de una página web concreta. Esta capacidad incluye, entre otras cosas, diferentes diseños de página web, tamaños de elementos de interfaz de usuario y resolución de ilustraciones.

El visor admite dos métodos para crear CSS con diseño interactivo: marcadores CSS y consultas de medios CSS estándar. Puede utilizar estos métodos de forma independiente o conjunta.

Marcadores CSS

Para ayudar a crear CSS diseñado interactivo, el visor admite marcadores CSS que asignan clases CSS especiales de forma dinámica al elemento contenedor del visor de nivel superior. Las asignaciones se basan en el tamaño del visor en tiempo de ejecución y en el tipo de entrada utilizado en el dispositivo actual.

El primer grupo de marcadores CSS incluye .s7size_large, .s7size_medium, y .s7size_small clases. Se aplican en función del área de tiempo de ejecución del contenedor de visor. Es decir, si el área de visualización es igual o mayor que el tamaño de un monitor de escritorio común .s7size_large se utiliza; si el área es de tamaño cercano a un dispositivo de tableta común .s7size_medium se ha asignado. Para áreas similares a las pantallas de teléfono móvil, .s7size_small está configurado. El propósito principal de estos marcadores CSS es crear diferentes diseños de interfaz de usuario para diferentes pantallas y tamaños de visor.

El segundo grupo de marcadores CSS incluye .s7mouseinput y .s7touchinput. El marcador .s7touchinput se establece si el dispositivo actual tiene capacidades de entrada táctil; de lo contrario, .s7mouseinput se utiliza. Estos marcadores están pensados para crear elementos de entrada de interfaz de usuario con diferentes tamaños de pantalla para diferentes tipos de entrada, ya que normalmente la entrada táctil requiere elementos más grandes. En los casos en que el dispositivo tenga capacidades táctiles y de entrada de ratón, .s7touchinput se configura y el visualizador procesa una interfaz de usuario táctil.

El siguiente CSS de ejemplo establece el tamaño del botón de zoom en 28 x 28 píxeles en sistemas con entrada de ratón y 56 x 56 píxeles en dispositivos táctiles. Además, oculta el botón por completo si el tamaño del visor se vuelve pequeño:

.s7flyoutviewer.s7mouseinput .s7swatches .s7thumb {
 width: 28px;
 height: 28px;
}
.s7flyoutviewer.s7touchinput .s7swatches .s7thumb {
 width: 56px;
 height: 56px;
}
.s7flyoutviewer.s7size_small .s7swatches {
 visibility: hidden;
}

Para dirigirse a dispositivos con una densidad de píxeles diferente, utilice consultas de medios CSS. El siguiente bloque de consulta de medios contendría CSS específico para pantallas de alta densidad:

@media screen and (-webkit-min-device-pixel-ratio: 1.5)
{
}

El uso de marcadores CSS es la forma más flexible de crear CSS con diseño interactivo. Permite dirigirse no solo al tamaño de pantalla del dispositivo, sino al tamaño real del visor, lo que puede resultar útil para los diseños de página web interactivos.

Consultas de medios CSS

La detección de dispositivos también se puede realizar utilizando consultas de medios CSS puras. Todo lo incluido dentro de un bloque de consulta de medios determinado se aplica solo cuando se ejecuta en un dispositivo correspondiente.

Cuando se aplica a visores móviles, utilice cuatro consultas de medios CSS, definidas en el CSS en el siguiente orden:

1. Contiene solo reglas específicas para todos los dispositivos táctiles.

   @media only screen and (max-device-width:13.5in) and (max-device-height:13.5in) and (max-device-width:799px),
   only screen and (max-device-width:13.5in) and (max-device-height:13.5in) and (max-device-height:799px)
   {
   }
   

2. Contiene solo reglas específicas para tabletas con pantallas de alta resolución.

   @media only screen and (max-device-width:13.5in) and (max-device-height:13.5in) and (max-device-width:799px) and (-webkit-min-device-pixel-ratio:1.5),
   only screen and (max-device-width:13.5in) and (max-device-height:13.5in) and (max-device-height:799px) and (-webkit-min-device-pixel-ratio:1.5)
   {
   }
   

3. Contiene solo reglas específicas para todos los teléfonos móviles.

   @media only screen and (max-device-width:9in) and (max-device-height:9in)
   {
   }
   

4. Contiene únicamente reglas específicas para teléfonos móviles con pantallas de alta resolución.

   @media only screen and (max-device-width:9in) and (max-device-height:9in) and (-webkit-min-device-pixel-ratio: 1.5),
     only screen and (device-width:720px) and (device-height:1280px) and (-webkit-device-pixel-ratio: 2),
     only screen and (device-width:1280px) and (device-height:720px) and (-webkit-device-pixel-ratio: 2)
   {
   }
   

Con un enfoque de consultas de medios, debe organizar CSS con detección de dispositivos de la siguiente manera:

• En primer lugar, la sección específica del escritorio define todas las propiedades que son específicas del escritorio o comunes a todas las pantallas.
• Y segundo, las cuatro consultas de medios van en el orden definido arriba y proporcionan reglas CSS específicas para el tipo de dispositivo correspondiente.

No es necesario duplicar todo el visor de CSS en cada consulta de medios. Solo las propiedades específicas de dispositivos determinados se redefinen dentro de una consulta de medios.

Sprites CSS

Muchos elementos de la interfaz de usuario del visor tienen un estilo que utiliza ilustraciones de mapa de bits y tienen más de un estado visual distinto. Un buen ejemplo es un botón que normalmente tiene al menos tres estados diferentes: "arriba", "sobre" y "abajo". Cada estado requiere su propia ilustración de mapa de bits asignada.

Con un enfoque clásico del estilo, el CSS tendría una referencia independiente a un archivo de imagen individual en el servidor para cada estado del elemento de interfaz de usuario. El siguiente es un ejemplo de CSS para aplicar estilo a un botón de desplazamiento:

.s7flyoutviewer .s7swatches .s7scrollleftbutton[state="up"]{
background-image:url(images/v2/ScrollLeftButton_up.png);
}
.s7flyoutviewer .s7swatches .s7scrollleftbutton[state="over"]{
background-image:url(images/v2/ScrollLeftButton_over.png);
}
.s7flyoutviewer .s7swatches .s7scrollleftbutton[state="down"]{
background-image:url(images/v2/ScrollLeftButton_down.png);
}
.s7flyoutviewer .s7swatches .s7scrollleftbutton[state="disabled"]{
background-image:url(images/v2/ScrollLeftButton_disabled.png);
}

El inconveniente de este enfoque es que el usuario final experimenta parpadeos o una respuesta retrasada en la interfaz de usuario cuando el elemento interactúa con por primera vez. Esta acción se produce porque la ilustración de la imagen para el nuevo estado del elemento aún no se ha descargado. Además, este método puede tener un ligero impacto negativo en el rendimiento debido al aumento en el número de llamadas HTTP al servidor.

Los sprites CSS son un enfoque diferente en el que la ilustración de la imagen para todos los estados de elementos se combina en un solo archivo PNG llamado "sprite". Este "sprite" tiene todos los estados visuales para el elemento dado colocados uno tras otro. Al aplicar estilo a un elemento de interfaz de usuario con sprites, se hace referencia a la misma imagen sprite para todos los estados diferentes en CSS. Además, la variable background-position se utiliza la propiedad para cada estado para especificar qué parte de la imagen "sprite" se utiliza. Puede estructurar una imagen "sprite" de cualquier manera adecuada. Los visualizadores normalmente lo tienen apilado verticalmente. A continuación se muestra un ejemplo basado en "sprite" de cómo aplicar estilo al mismo botón de desplazamiento desde arriba:

.s7flyoutviewer .s7scrollleftbutton[state]  {
    background-image: url(images/v2/ScrollLeftButton_light_sprite.png);
}
.s7flyoutviewer .s7swatches .s7scrollleftbutton[state="up"]{
background-position: -56px -504px;
}
.s7flyoutviewer .s7swatches .s7scrollleftbutton[state="over"]{
background-position: -0px -504px;
}
.s7flyoutviewer .s7swatches .s7scrollleftbutton[state="down"]{
background-position: -56px -448px;
}
.s7flyoutviewer .s7swatches .s7scrollleftbutton[state="disabled"]{
background-position: -0px -448px;
}

Notas y consejos generales sobre estilo

• Al personalizar la interfaz de usuario del visor con CSS, el uso de !IMPORTANT La regla de no es compatible con los elementos del visor de estilo. En particular, !IMPORTANT La regla no debe utilizarse para anular ningún estilo predeterminado o en tiempo de ejecución proporcionado por el visor o el SDK del visor. El motivo es que puede afectar al comportamiento de los componentes adecuados. En su lugar, debe utilizar selectores de CSS con la especificidad adecuada para establecer las propiedades CSS documentadas en esta guía de referencia.
• Todas las rutas a recursos externos dentro de CSS se resuelven en la ubicación de CSS, no en la ubicación de la página del HTML del visor. Tenga en cuenta esta regla al copiar el CSS predeterminado en una ubicación diferente. Copie también los recursos predeterminados o actualice las rutas dentro del CSS personalizado.
• El formato preferido para las ilustraciones de mapa de bits es PNG.
• La ilustración de mapa de bits se asigna a los elementos de interfaz de usuario utilizando background-image propiedad.
• El width y height Las propiedades de un elemento de interfaz de usuario definen su tamaño lógico. El tamaño del mapa de bits pasado a background-image no afecta al tamaño lógico.
• Para utilizar la alta densidad de píxeles de pantallas de alta resolución como Retina, especifique ilustraciones de mapa de bits dos veces más grandes que el tamaño del elemento de interfaz de usuario lógico. A continuación, aplique la variable -webkit-background-size:contain para reducir el fondo al tamaño del elemento de la interfaz de usuario lógica.
• Para quitar un botón de la interfaz de usuario, agregue. display:none a su clase CSS.
• Puede utilizar varios formatos para los valores de color que admite CSS. Si necesita transparencia, utilice el formato rgba(R,G,B,A). De lo contrario, puede utilizar el formato #RRGGBB.

Elementos comunes de la interfaz de usuario

A continuación se muestra la documentación de referencia de los elementos de la interfaz de usuario que se aplica al visor flotante: