DocumentaciónGuía de referencia de visores de Dynamic Media

Personalizar visor flotante customizing-flyout-viewer

Last update: Mon Jul 22 2024 00:00:00 GMT+0000 (Coordinated Universal Time)
  • Temas:

Creado para:

  • Desarrollador
  • Usuario

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 el comando style=.

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

<s7_viewers_root>/html5/FlyoutViewer.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.

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.

Al crear CSS personalizado, tenga en cuenta que el visor asigna la clase .s7flyoutviewer a su elemento DOM contenedor. Si está usando un archivo CSS externo pasado con el comando style=, use la clase .s7flyoutviewer como clase principal en el selector descendiente para 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 section-c1e74f5114ad418884ca1c95f5ea5b63

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. La asignación se basa 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 las clases .s7size_large, .s7size_medium y .s7size_small. Se aplican en función del área de tiempo de ejecución del contenedor de visor. Es decir, si el área del visor es igual o mayor que el tamaño de un monitor de escritorio común .s7size_large; si el área está cerca del tamaño de un dispositivo de tableta común .s7size_medium está asignado. Para áreas similares a las pantallas de teléfonos móviles, se ha establecido .s7size_small. 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, se utiliza .s7mouseinput. 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 los que el dispositivo tenga capacidades táctiles y de entrada de ratón, .s7touchinput se establece y el visor 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. El motivo es que le permite dirigirse no solo al tamaño de pantalla del dispositivo, sino también 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.

    code language-none 
    @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.

    code language-none 
    @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.

    code language-none 
    @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.

    code language-none 
    @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 section-0711ece44a4740168cfd7624c9010bd1

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 al 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 propiedad background-position se usa en cada estado para especificar qué parte de la imagen "sprite" se usa. 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 section-95855dccbbc444e79970f1aaa3260b7b

  • Al personalizar la interfaz de usuario del visor con CSS, no se admite el uso de la regla !IMPORTANT para aplicar estilo a los elementos del visor. En particular, la regla !IMPORTANT no debe usarse 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 ha asignado a elementos de interfaz de usuario utilizando la propiedad background-image.
  • Las propiedades width y height 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 propiedad -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, use el formato rgba(R,G,B,A). De lo contrario, puede utilizar el formato #RRGGBB.

Elementos comunes de la interfaz de usuario section-d6330c9be8c444aa9b2a07886e3dbc2a

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

recommendation-more-help
b7426f53-aad9-4c00-83fc-664f30f681e8