Componente Descarga

El componente principal Descarga permite crear una opción de descarga en una página.

Uso

El componente Descarga de componentes principales permite incluir una opción de descarga y su recurso asociado en una página.

• Las propiedades de la opción de descarga se pueden seleccionar en el cuadro de diálogo de configuración.
• Los valores predeterminados del componente Descarga se pueden definir en el cuadro de diálogo de diseño.

Versión y compatibilidad

La versión actual del componente Descargar es la versión 2, que se introdujo con la versión 2.18.0 de los componentes principales en febrero de 2022 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.

Salida del componente de ejemplo

Para experimentar el componente Descarga, así como 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 Descarga 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.

Cuadro de diálogo de configuración

El cuadro de diálogo de configuración permite al autor del contenido definir el elemento de descarga y cómo se comportará y aparecerá para un visitante de la página.

Pestaña Recurso

La selección de un recurso de descarga es muy similar a la funcionalidad del Componente Imagen y, del mismo modo, aprovecha AEM DAM.

• Recurso de descarga
  • 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 Propiedades

• Título: se muestra como un titular para el elemento de descarga
  • Obtener el título del recurso DAM: cuando se selecciona, el título se rellena automáticamente con el título del recurso DAM.
• Descripción: se muestra como un subtitular descriptivo del elemento de descarga
  • Obtener la descripción del recurso DAM: cuando se selecciona, la descripción se rellena automáticamente con la descripción del recurso DAM.
• Texto de acción: se muestra como texto de acción para el elemento de descarga
  • Este campo es necesario al cargar un recurso desde el sistema de archivos.
  • Mostrar elementos incorporados: al seleccionarlo, el texto de acción proporcionado se mostrará en línea.
• 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.

Pestaña Estilos

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

Utilice la lista desplegable para seleccionar los estilos que desea aplicar al componente. Las selecciones realizadas en el cuadro de diálogo de edición tienen el mismo efecto que las seleccionadas en la barra de herramientas de componentes.

Los estilos deben configurarse para este componente en el cuadro de diálogo de diseño para que el menú desplegable esté disponible.

Cuadro de diálogo de diseño

El cuadro de diálogo de diseño permite que el autor de la plantilla defina las opciones disponibles para el autor de contenido que utiliza el componente Descarga.

Pestaña Propiedades

• Permitir la carga desde el sistema de archivos: permite al autor del contenido cargar un recurso desde su sistema de archivos local como recurso de descarga.
  • El valor predeterminado no está seleccionado.
• Tipo de título: el elemento HTML utilizado para el título del componente Descarga.
  • Si no se selecciona ningún valor, el valor predeterminado es H3.
• Mostrar el tamaño de archivo: cuando se selecciona, el tamaño de archivo del recurso se muestra en el componente Descarga.
  • El valor predeterminado está seleccionado.
• Mostrar el formato de archivo: cuando se selecciona, el formato de archivo del recurso se muestra en el componente Descarga.
  • El valor predeterminado está seleccionado.
• Mostrar el nombre de archivo: al seleccionarlo, el nombre de archivo del recurso se mostrará en el componente Descarga.
  • El valor predeterminado está seleccionado.

Pestaña Estilos

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