Skip to content

Image with caption

ibmdotcom-bot edited this page Feb 2, 2022 · 90 revisions

Decorator UI component

This component wraps the responsive Image component we’ve built and provides it with a caption, and option to zoom in to see a larger and clearer version of the image.

component--media--embedded-image--states--design-specs


Table of contents

Dependencies (2)

Used by (7)

Back links (6)

Content block simple (1)

  • ...a single Content item, optional media (Image with caption

Content group simple (1)

  • an optional media item (Image with caption or Video)

Content item horizontal (2)

  • media here is can be an Image with caption or a
  • See Image with caption and Video for more

Content item (2)

  • the adopter with option to use either Image with caption
  • See Image with caption for more

Resources



1. Image

required component

Events
event description
1.0.1 onClick && 4.0.2 Launches the Lightbox media viewer 4 if enabled. The whole image area is clickable.

image See Image for more details

image See design specs r1 for visual states


Back to top


2. Caption

optional string

A short descriptive text that lives below the image.

Logic
condition description
2.0.1 4.0.2 String of text is passed to Lightbox media viewer's' 4 heading


Back to top


3. Button icon

The button icon is displayed only if the Lightbox media viewer 4 is enabled to help communicate to the user that they can view this image with more detail.

Logic
condition description
3.0.1 4.0.1 Button is hidden.
3.0.1 4.0.2 Button is displayed.

image See design specs r1 for visual states


4. Lightbox media viewer

optional component

component--media--embedded-image--states--design-specs copy

Logic
condition description
4.0.1 false default disables the the use of Lightbox media viewer
4.0.2 true Enables the the use of Lightbox media viewer

image See Lightbox media viewer for more details


4.1 Image

component

The Image here mirrors the Image 1 component from above.


4.2 Heading

string

This string of text mirrors the Caption 2 content outlined above.


4.3 Copy

optional string

An optional paragraph of text that allows the author to provide more details around the image.


Back to top


Website guidelines

Publishing guidelines (6)

Functional specs

Layout component (37)
Service (3)
UI component (34)
Utility (5)

Additional components

Carbon component (19)
Design only (9)
Feature flag (3)
Clone this wiki locally