<iframe src="https://www.googletagmanager.com/ns.html?id=GTM-5HGSQD2L" height="0" width="0" style="display:none;visibility:hidden" title="GTM"></iframe>

Thumbnails Hero

A carousel of large images with thumbnails navigation.
styleKeys: thumbnailsHero

Use Thumbnails Hero...

  • To display, in a hero spot on Product pages, a series of large images with thumbnails, within a carousel.

Don't use Thumbnails Hero...

  • On other pages than Product pages or elsewhere within the Product page. Use a Carousel or a Banner instead.

Default

The preview has been updated.

Video Slide

Use ThumbnailsHeroVideoThumbnailSlide instead of CarouselSlide to display a "play" icon over the thumbnail image for slides containing video content.

The preview has been updated.

Current slide

Use currentSlide to programmatically select a specific slide by providing the slide's index as the prop value. This method directly sets the active slide in the carousel.

Initially, ThumbnailsHero renders with the selected slide already chosen. When the currentSlide prop changes, it triggers a re-render, and the carousel animates towards the newly selected slide.

Use onSlideChange to track changes to the current slide, which can occur through user actions like clicking a thumbnail or swiping.

The preview has been updated.

Implementation

Within ThumbnailsHeroThumbnailsSlidesContainer, use CarouselSlide or ThumbnailsHeroVideoThumbnailSlide with a square Fluid Image to display the thumbnail of an image or a video.

Within ThumbnailsHeroImagesSlidesContainer, use CarouselSlide to display the corresponding large Fluid Image or video.

Within ThumbnailsHeroBackgroundContainer, use the same first large Fluid Image as for ThumbnailsHeroImagesSlidesContainer as a placeholder to ensure visually seamless loading of the carousel.

Share

Accessibility

Use accessibleTextForDots to provide accessible text for slide controllers.

Content

Image

  • Use Thumbnails Hero with Fluid Image.
  • Use square images for the thumbnails. They are displayed at a pre-set height and width of 64px: the images are scaled down as needed.
  • The height of the Thumbnails Hero is determined by the height of the ThumbnailsHeroContentContainer. Large images may get zoomed, clipped, or scaled to match.

Text

  • Localize each slide title for accessibleTextForDots.

Props

ThumbnailsHero
This component is implemented using the <div /> as the root element. You can utilize the native attributes supported by <div /> tag. The ref is directly assigned to the root element, allowing you to access and manipulate it as needed.
See core props for additional props that can be applied to this component.
proptyperequireddescriptiondefault
accessibleTextForDotsstring[]true
Provide accessible text for slide controllers
null
currentSlidenumber | nullfalse
The index of the slide to select
null
onSlideChange((currentIndex: number, targetIndex: number) => void) | nullfalse
A callback fired when the ThumbnailsHero changes the selected slide. It is passed the index of the currently selected slide and the index of the slide it will change to
null
ThumbnailsHeroContentContainer
This component is implemented using the <div /> as the root element. You can utilize the native attributes supported by <div /> tag. The ref is directly assigned to the root element, allowing you to access and manipulate it as needed.
See core props for additional props that can be applied to this component.
ThumbnailsHeroContent
This component is implemented using the <div /> as the root element. You can utilize the native attributes supported by <div /> tag. The ref is directly assigned to the root element, allowing you to access and manipulate it as needed.
See core props for additional props that can be applied to this component.
ThumbnailsHeroImagesSlidesContainer
This component is implemented using the <div /> as the root element. You can utilize the native attributes supported by <div /> tag. The ref is directly assigned to the root element, allowing you to access and manipulate it as needed.
See core props for additional props that can be applied to this component.
ThumbnailsHeroThumbnailsSlidesContainer
This component is implemented using the <div /> as the root element. You can utilize the native attributes supported by <div /> tag. The ref is directly assigned to the root element, allowing you to access and manipulate it as needed.
See core props for additional props that can be applied to this component.
ThumbnailsHeroBackgroundContainer
This component is implemented using the <div /> as the root element. You can utilize the native attributes supported by <div /> tag. The ref is directly assigned to the root element, allowing you to access and manipulate it as needed.
See core props for additional props that can be applied to this component.

Related