Componente Imagen

El componente de imagen del componente principal es un componente de imagen adaptable que incluye la edición in situ.

Uso

El componente de imagen presenta una selección de imágenes adaptativa y un comportamiento interactivo con carga diferida para el visitante de la página, así como una ubicación y un recorte sencillos de la imagen para el autor del contenido.

El autor de la plantilla puede definir los anchos de la imagen, así como el recorte y la configuración adicional en el cuadro de diálogo de diseño. El editor de contenido puede cargar o seleccionar recursos en el cuadro de diálogo de configuración y recortar la imagen en el cuadro de diálogo de edición. Para una mayor comodidad, también está disponible una modificación simple in situ de la imagen.

Funciones adaptables

El componente de imagen incluye funciones adaptables sólidas listas para usar. En el nivel de plantilla de página, se puede utilizar el cuadro de diálogo de diseño para definir los anchos predeterminados del recurso de imagen. El componente de imagen cargará automáticamente la anchura correcta para mostrarla según el tamaño de la ventana del explorador. A medida que cambia el tamaño de la ventana, el componente de imagen carga dinámicamente el tamaño de imagen correcto sobre la marcha. No es necesario que los desarrolladores de componentes se preocupen por definir consultas de medios personalizadas, ya que el componente de imagen ya está optimizado para cargar el contenido.

Además, el componente de imagen admite la carga diferida para aplazar la carga del recurso de imagen real hasta que sea visible en el explorador, lo que aumenta la capacidad de respuesta de las páginas.

Asistencia de Dynamic Media

El componente de imagen (a partir de la versión 2.13.0) admite recursos de Dynamic Media. Cuando están habilitadas, estas funciones permiten agregar recursos de imagen de Dynamic Media con tan solo arrastrar y soltar o mediante el explorador de recursos como lo haría con cualquier otra imagen. Además, también se admiten modificadores de imagen, ajustes preestablecidos de imagen y cultivos inteligentes.

Las experiencias web creadas con los componentes principales no pueden ofrecer funciones de imagen de Dynamic Media enriquecidas, potentes, sólidas y de alto rendimiento en varias plataformas.

Versión y compatibilidad

La versión actual del componente de imagen es la versión 2, que se introdujo con la versión 2.0.0 de los componentes principales en enero de 2018 y se describe en este documento.

La siguiente tabla detalla todas las versiones compatibles del componente, las versiones de AEM con las que son compatibles las versiones del componente y los vínculos a la documentación de versiones anteriores.

Para obtener más información sobre las versiones y publicaciones de los componentes principales, consulte el documento Versiones de los componentes principales.

Compatibilidad con SVG

Los gráficos vectoriales escalables (SVG) son compatibles con el componente de imagen.

• Se admiten las funciones de arrastrar y soltar un recurso SVG desde DAM y de cargar un archivo SVG cargado desde un sistema de archivos local.
• El servlet de imagen adaptable transmite el archivo SVG original en flujo (las transformaciones se omiten).
• Para una imagen SVG, las "imágenes inteligentes" y los "tamaños inteligentes" se establecen en una matriz vacía en el modelo de imagen.

Seguridad

Por motivos de seguridad, el Editor de imágenes nunca llama directamente al SVG original. Se llama a través de <img src=“path-to-component”>. Esto evita que el explorador ejecute cualquier script incrustado en el archivo SVG.

Salida del componente de ejemplo

Para experimentar el componente de imagen y ver ejemplos de sus opciones de configuración, así como la salida HTML y JSON, visite la Biblioteca de componentes.

Detalles técnicos

La documentación técnica más reciente sobre el componente de imagen se encuentra en GitHub.

Puede encontrar más información sobre el desarrollo de componentes principales en la documentación para desarrolladores de componentes principales.

El componente de imagen admite microdatos schema.org.

Cuadro de diálogo de configuración

Además del cuadro de diálogo de edición y del cuadro de diálogo de diseño estándar, el componente de imagen ofrece un cuadro de diálogo de configuración en el que la propia imagen se define junto con su descripción y propiedades básicas.

Pestaña Recurso

• Recurso de imagen
  • Coloque un recurso desde el navegador de recursos o pulse la opción examinar para cargar desde un sistema de archivos local.
  • Pulse o haga clic en Borrar para anular la selección de la imagen seleccionada actualmente.
  • Pulse o haga clic en Editar para administrar las representaciones del recurso en el editor de recursos.

Pestaña de metadatos

• Tipo de ajuste preestablecido: define los tipos de ajustes preestablecidos de imagen disponibles, ya sea Ajustes preestablecidos de imágenes o Recorte inteligente, y solo está disponible cuando las funciones de Dynamic Media están habilitadas.
  • Ajuste preestablecido de imagen: cuando se selecciona Tipo de ajuste preestablecido de ajustes de imagen preestablecidos, está disponible la opción desplegable Ajustes de imagen preestablecidos, que permite seleccionar entre los ajustes preestablecidos disponibles de Dynamic Media. Esto solo está disponible si se han definido ajustes preestablecidos para el recurso seleccionado.
  • Recorte inteligente: cuando se selecciona Tipos de ajustes preestablecidos de recorte inteligente, está disponible la lista desplegable Representación, que permite seleccionar entre las representaciones disponibles del recurso seleccionado. Esto solo está disponible si las representaciones están definidas para el recurso seleccionado.
  • Modificadores de imagen: los comandos de servidor de imágenes adicionales de Dynamic Media se pueden definir aquí separados por &, independientemente de los tipos de ajustes preestablecidos seleccionados.
• La imagen es decorativa: compruebe si la tecnología de asistencia debe ignorar la imagen y, por lo tanto, no requiere un texto alternativo. Esto solo se aplica a imágenes decorativas.
• Texto alternativo: texto alternativo del significado o la función de la imagen, para usuarios con problemas de visión.
  • Obtener texto alternativo de DAM: cuando se selecciona, el texto alternativo de la imagen se rellena con el valor de los metadatos dc:description en DAM.
• Pie de ilustración: información adicional sobre la imagen que se muestra debajo de la imagen de forma predeterminada.
  • Obtener pie de ilustración de DAM: cuando se marca, el texto del pie de la imagen se rellena con el valor de los metadatos dc:title de DAM.
  • Mostrar pie de ilustración como elemento emergente: cuando esta opción está activada, el pie de ilustración no se mostrará debajo de la imagen, sino como una ventana emergente que se muestra en algunos exploradores al pasar el ratón por encima de la imagen.
• Vínculo: vincule la imagen a otro recurso.
  • Utilice el cuadro de diálogo de selección para vincular a otro recurso de AEM.
  • Si no se vincula a un recurso de AEM, introduzca la dirección URL absoluta. Las direcciones URL no resueltas se interpretarán como relativas a AEM.
• ID: esta opción permite controlar el identificador único del componente del HTML y de la capa de datos.
  • Si se deja en blanco, se generará automáticamente un ID único que se puede encontrar inspeccionando la página resultante.
  • Si se especifica un ID, es responsabilidad del autor asegurarse de que sea único.
  • Cambiar el ID puede afectar al seguimiento de CSS, JS y de la capa de datos.

Cuadro de diálogo de edición

El cuadro de diálogo de edición permite al autor del contenido recortar, modificar el mapa de lanzamiento y ampliar la imagen.

• Iniciar recorte

  

  Al seleccionar esta opción, se abrirá una lista desplegable para las proporciones de recorte predefinidas.

  • Elija la opción Mano alzada para definir su propio recorte.
  • Elija la opción Quitar recorte para mostrar el recurso original.

  Una vez seleccionada una opción de recorte, utilice los controladores azules para cambiar el tamaño del recorte en la imagen.

  

• Girar a la derecha

  

  Utilice esta opción para girar la imagen 90° a la derecha (en el sentido de las agujas del reloj).

• Voltear horizontalmente

  

  Utilice esta opción para voltear la imagen horizontalmente o girar la imagen 180° a lo largo del eje y.

• Voltear verticalmente

  

  Utilice esta opción para voltear la imagen verticalmente o girar la imagen 180° a lo largo del eje x.

• Restablecer zoom

  

  Si la imagen ya se ha ampliado, utilice esta opción para restablecer el nivel de zoom.

• Abrir deslizador del zoom

  

  Utilice esta opción para mostrar un control deslizante para controlar el nivel de zoom de la imagen.

  

El editor in situ también se puede utilizar para modificar la imagen. Debido a las limitaciones de espacio, solo las opciones básicas están disponibles en línea. Para obtener opciones de edición completas, utilice el modo de pantalla completa.

Cuadro de diálogo de diseño

El cuadro de diálogo de diseño permite al autor de la plantilla definir las opciones de recorte, carga y rotación que tiene el autor del contenido al utilizar este componente.

Pestaña Principal

En la pestaña Principal puede definir una lista de anchuras en píxeles para la imagen y el componente cargará automáticamente la anchura más adecuada en función del tamaño del explorador. Esta es una parte importante de las funciones adaptables del componente de imagen.

Además, puede definir qué opciones generales de componentes se desactivan o se desactivan automáticamente cuando el autor agregue el componente a una página.

• Habilitar funciones de DM: cuando esté marcada, las funciones de activación de Dynamic Media estarán disponibles.
• Habilitar carga diferida: defina si la opción de carga diferida se habilita automáticamente al añadir el componente de imagen a una página.
• La imagen es decorativa: defina si la opción de imagen decorativa se habilita automáticamente al añadir el componente de imagen a una página.
• Obtener texto alternativo de DAM: defina si la opción para recuperar el texto alternativo de DAM se habilita automáticamente al añadir el componente de imagen a una página.
• Obtener pie de ilustración de DAM: defina si la opción para recuperar el pie de ilustración de DAM se habilita automáticamente al añadir el componente de imagen a una página.
• Mostrar el pie de ilustración como elemento emergente: defina si la opción para mostrar el pie de ilustración como elemento emergente se habilita automáticamente al agregar el componente de imagen a una página.
• Deshabilitar el seguimiento UUID: márquelo para deshabilitar el seguimiento del UUID del recurso de imagen.
• Anchura: define una lista de anchuras en píxeles para la imagen y el componente y carga automáticamente la anchura más adecuada en función del tamaño del explorador.
  • Pulse o haga clic en el botón Añadir para añadir otro tamaño.
    • Utilice los asideros para reorganizar el orden de los tamaños.
    • Utilice el icono Eliminar para eliminar una anchura.
  • De forma predeterminada, la carga de imágenes se aplazará hasta que se vuelva visible.
    • Seleccione la opción Deshabilitar la carga lenta para cargar las imágenes al cargar la página.
• Calidad JPEG: el factor de calidad (indicado en porcentajes de 0 a 100) para imágenes JPEG transformadas (por ejemplo, escaladas o recortadas).

Pestaña Características

En la pestaña Características puede definir qué opciones están disponibles para los autores de contenido al utilizar el componente, incluidas las opciones de carga, orientación y recorte.

• Origen

  

  Seleccione la opción Permitir carga de recursos desde el sistema de archivos para permitir que los autores de contenido carguen imágenes desde su equipo local. Para obligar a los autores de contenido a seleccionar solo recursos de AEM, anule la selección de esta opción.

• Orientación

  

• Rotar
  Utilice esta opción para permitir que el autor de contenido utilice la opción de
  Girar a la derecha.

• Voltear
  Utilice esta opción para permitir que el autor de contenido utilice las opciones
  Voltear horizontalmente y voltear verticalmente.

  PRECAUCIÓN

  La opción Voltear está desactivada de forma predeterminada. Al activarla, se mostrarán los botones Voltear verticalmente y Voltear horizontalmente en el cuadro de diálogo de edición del componente de imagen, pero la función no es compatible actualmente con AEM y los cambios realizados con estas opciones no se mantendrán.

• Recortar

  

  Seleccione la opción Permitir recorte para permitir que el autor del contenido recorte la imagen en el componente en el cuadro de diálogo de edición.

  • Haga clic en Añadir para añadir una relación de aspecto de recorte predefinida.
  • Introduzca un nombre descriptivo que se mostrará en la lista desplegable Iniciar recorte.
  • Introduzca la relación numérica del aspecto.
  • Utilice los controles de arrastre para reorganizar el orden de las relaciones de aspecto
  • Utilice el icono de la papelera para eliminar una relación de aspecto.
  PRECAUCIÓN

  Tenga en cuenta que, en AEM, las relaciones de aspecto de recorte se definen como altura/anchura. Esto es distinto de la definición convencional de anchura/altura y se realiza por motivos de compatibilidad con sistemas anteriores. Los autores de contenido no notarán ninguna diferencia siempre que proporcione un nombre claro de la relación, ya que el nombre se muestra en la interfaz de usuario y no en la propia relación.

Pestaña Estilos

El componente Imagen es compatible con el sistema de estilos de AEM.

Servlet de imagen adaptable

El componente de imagen utiliza el servlet de imagen adaptable del componente principal. El servlet de imagen adaptable es responsable del procesamiento y la transmisión de imágenes y los desarrolladores pueden aprovecharlo en sus personalizaciones de los componentes principales.

Optimización de la selección de representaciones

El servlet de imagen adaptable intentará elegir la mejor representación para el tamaño y tipo de imagen solicitado. Se recomienda que las representaciones DAM y los anchos permitidos de los componentes de imagen se definan de forma sincronizada, de modo que el Servlet de imagen adaptable realice el menor procesamiento posible.

Esto mejorará el rendimiento y evitará que la biblioteca de procesamiento de imágenes subyacente no procese correctamente algunas imágenes.

Capa de datos del cliente de Adobe

El componente de imagen es compatible con la capa de datos del cliente de Adobe.