Image Component (v2) image-component

Image asset

• Drop an asset from the asset browser or tap the browse option to upload from a local file system.
• Tap or click Clear to de-select the currently selected image.
• Tap or click Edit to mange the renditions of the asset in the asset editor.

Preset Type - This defines the types of image presets available, either Image Preset or Smart Crop, and is only available when Dynamic Media features are enabled.

• Image Preset - When Preset Type of Image Preset is selected, the drop down Image Preset is available, allowing selection from the available Dynamic Media presets. This is only available if presets are defined for the selected asset.
• Smart Crop - When Preset Type of Smart Crop is selected the drop down Rendition is available, allowing selection from the available renditions of teh selected asset. This is only available if renditions are defined for the selected asset.
• Image Modifiers - Additional Dynamic Media image serving commands can be defined here separated by &, regardless of which Preset Type is selected.

Image is decorative - Check if the image should be ignored by assistive technology and therefore does not require an alternative text. This applies to decorative images only.

Alternative text - Textual alternative of the meaning or function of the image, for visually impaired readers.

• Get alternative text from DAM - When checked the image’s alternative text will be populated with the value of the dc:description metadata in DAM.

Caption - Additional information about the image, displayed below the image by default.

• Get caption from DAM - When checked the image’s caption text will be populated with the value of the dc:title metadata in DAM.
• Display caption as pop-up - When checked, the caption won’t be displayed below the image, but as a pop-up displayed by some browsers when hovering over the image.

Link - Link the image to another resource.

• Use the selection dialog to link to another AEM resource.
• If not linking to an AEM resource, enter the absolute URL. Non-solute URLs will be interpreted as relative to AEM.

ID - This option allows to control the unique identifier of the component in the HTML and in the Data Layer.

• If left blank, a unique ID is automatically generated for you and can be found by inspecting the resulting page.
• If an ID is specified, it is the responsibility of the author to make sure that it is unique.
• Changing the ID can have an impact on CSS, JS and Data Layer tracking.

Start Crop

Selecting this option opens a drop-down for pre-defined crop proportions.

• Choose the option Free Hand to define your own crop.
• Choose the option Remove Crop to display the original asset.

Once a crop option is selected, use the blue handles to size the crop on the image.

Rotate Right

Use this option to rotate the image 90° to the right (clockwise).

Flip Horizontally

Use this option to to flip the image horizontally or pivot the image 180° along the y-axis.

Flip Vertically

Use this option to to flip the image vertically or pivot the image 180° along the x-axis.

Reset Zoom

If the image has already been zoomed, use this option to reset the zoom level.

Open Zoom Slider

Use this option to display a slider to control the zoom level of the image.

Enable DM features - When checked, the enable Dynamic Media features are available.

Enable Web Optimized Images - When checked, the web-optimized image delivery service will deliver images in the WebP format, reducing image sizes on average by 25%.

• This option is only available in AEMaaCS.
• When unchecked or the web-optimized image delivery service is unavailable the Adaptive Image Servlet is used.

Enable lazy loading - Define if the lazy loading option is automatically enabled when adding the image component to a page.

Image is decorative - Define if the decorative image option is automatically enabled when adding the image component to a page.

Get alternative text from DAM- Define if the option to retrieve the alternate text from the DAM is automatically enabled when adding the image component to a page.

Get caption from DAM - Define if the option to retrieve the caption from the DAM is automatically enabled when adding the image component to a page.

Display caption as pop-up - Define if the option to display the image caption as a pop-up is automatically enabled when adding the image component to a page.

Disable UUID Tracking - Check to disable the tracking of the image asset’s UUID.

Widths - Defines a list of widths in pixels for the image and the component automatically loads the most appropriate width based on browser size.

• Tap or click the Add button to add another size.

  • Use the grab handles to re-arrange the order of the sizes.
  • Use the Delete icon to remove a width.

• By default images loading is deferred until they become visible.

  • Select the option Disable lazy loading to load the images upon page load.

JPEG Quality - The quality factor (in percentage from 0 and 100) for transformed (e.g. scaled or cropped) JPEG images.

Source

Select the option Allow asset upload from file system to allow content authors to upload images from his or her local computer. To force content authors to only select assets from AEM, de-select this option.

Orientation

Rotate
Use this option to allow the content author to use the Rotate Right option.

Flip
Use this option to allow the content author to use the Flip Horizontally and Flip Vertically options.

Cropping

Select the option Allow crop to allow the content author to crop the image in the component in the edit dialog.

• Click Add to add a pre-defined crop aspect ratio.
• Enter a descriptive name, which will be shown in the Start Crop dropdown.
• Enter the numerical ratio of the aspect.
• Use the drag handles to re-arrange the order of the aspect ratios
• Use the trash can icon to delete an aspect ratio.