Image Galleries with amp-carousel

Edit on Github
Open in Playground

Introduction

The amp-carousel component works great for image galleries. The carousel requires the height attribute to be specified in advance. This can be tricky if the displayed images and captions vary in size. Here are two approaches to solve this problem.

Setup

Import the carousel component in the header.

<script async custom-element="amp-carousel" src="https://cdn.ampproject.org/v0/amp-carousel-0.1.js"></script>

We will also be using the amp-fit-text component.

<script async custom-element="amp-fit-text" src="https://cdn.ampproject.org/v0/amp-fit-text-0.1.js"></script>

We will also be using the amp-selector component.

<script async custom-element="amp-selector" src="https://cdn.ampproject.org/v0/amp-selector-0.1.js"></script>

We will also be using the amp-bind component.

<script async custom-element="amp-bind" src="https://cdn.ampproject.org/v0/amp-bind-0.1.js"></script>

Dynamic Text Size

The first image gallery uses amp-fit-text to fit the text to the available space. This works well if captions vary not too much in length.

Example

The Border Collie is a working and herding dog breed developed in the Anglo-Scottish border region for herding livestock, especially sheep. It was specifically bred for intelligence and obedience. Considered highly intelligent, and typically extremely energetic, acrobatic, smart and athletic, they frequently compete with great success in dog sports, in addition to their success in sheepdog trials. They are often cited as the most intelligent of all domestic dogs. Border Collies also remain employed throughout the world in their traditional work of herding livestock.
The Shetland Sheepdog, often known as the Sheltie, is a breed of herding dog. Less favored nicknames are the Toy Collie and the Miniature Collie. They are small dogs, and come in a variety of colors, such as sable, tri-color, and blue merle. They are very intelligent, vocal, excitable, energetic dogs who are always willing to please and work hard.
The Hovawart is a medium to large size German dog breed. The name of the breed means "an estate guard dog", which is the original use for the breed. The breed originated in the Black Forest region and was first described in text and paintings in medieval times.
<amp-carousel class="carousel1"
  layout="responsive"
  height="450"
  width="500"
  type="slides">
  <div class="slide">
    <amp-img src="/img/Border_Collie.jpg"
      layout="responsive"
      width="500"
      height="300"
      alt="Border Collie"></amp-img>
    <amp-fit-text layout="responsive"
      width="500"
      height="150"> The Border Collie is a working and herding dog breed developed in the Anglo-Scottish border region for herding livestock, especially sheep. It was specifically bred for intelligence and obedience. Considered highly intelligent, and typically extremely
      energetic, acrobatic, smart and athletic, they frequently compete with great success in dog sports, in addition to their success in sheepdog trials. They are often cited as the most intelligent of all domestic dogs. Border Collies also remain
      employed throughout the world in their traditional work of herding livestock. </amp-fit-text>
  </div>

  <div class="slide">
    <amp-img src="/img/Shetland_Sheepdog.jpg"
      layout="responsive"
      width="500"
      height="340"
      alt="Shetland Sheepdog"></amp-img>
    <amp-fit-text layout="responsive"
      width="500"
      height="110"> The Shetland Sheepdog, often known as the Sheltie, is a breed of herding dog. Less favored nicknames are the Toy Collie and the Miniature Collie. They are small dogs, and come in a variety of colors, such as sable, tri-color, and blue merle. They
      are very intelligent, vocal, excitable, energetic dogs who are always willing to please and work hard.
    </amp-fit-text>
  </div>

  <div class="slide">
    <amp-img src="/img/Hovawart.jpg"
      layout="responsive"
      width="500"
      height="350"
      alt="Hovawart"></amp-img>
    <amp-fit-text layout="responsive"
      width="500"
      height="100">
      The Hovawart is a medium to large size German dog breed. The name of the breed means "an estate guard dog", which is the original use for the breed. The breed originated in the Black Forest region and was first described in text and paintings in medieval
      times.
    </amp-fit-text>
  </div>
</amp-carousel>

Text Overlay

Another carousel with caption, this time the caption overlays the image.

Example

The Border Collie is a working and herding dog breed developed in the Anglo-Scottish border region for herding livestock, especially sheep. It was specifically bred for intelligence and obedience.
The Shetland Sheepdog, often known as the Sheltie, is a breed of herding dog. Less favored nicknames are the Toy Collie and the Miniature Collie. They are small dogs, and come in a variety of colors, such as sable, tri-color, and blue merle. They are very intelligent, vocal, excitable, energetic dogs who are always willing to please and work hard.
The Hovawart is a medium to large size German dog breed. The name of the breed means "an estate guard dog", which is the original use for the breed. The breed originated in the Black Forest region and was first described in text and paintings in medieval times.
<amp-carousel class="carousel2"
  layout="responsive"
  height="400"
  width="500"
  type="slides">
  <div class="slide">
    <amp-img src="/img/Border_Collie.jpg"
      layout="fill"
      alt="Border Collie"></amp-img>
    <div class="caption">
      The Border Collie is a working and herding dog breed developed in the Anglo-Scottish border region for herding livestock, especially sheep. It was specifically bred for intelligence and obedience.
    </div>
  </div>

  <div class="slide">
    <amp-img src="/img/Shetland_Sheepdog.jpg"
      layout="fill"
      alt="Shetland Sheepdog"></amp-img>
    <div class="caption">
      The Shetland Sheepdog, often known as the Sheltie, is a breed of herding dog. Less favored nicknames are the Toy Collie and the Miniature Collie. They are small dogs, and come in a variety of colors, such as sable, tri-color, and blue merle. They are
      very intelligent, vocal, excitable, energetic dogs who are always willing to please and work hard.
    </div>
  </div>

  <div class="slide">
    <amp-img src="/img/Hovawart.jpg"
      layout="fill"
      alt="Hovawart"></amp-img>
    <div class="caption">
      The Hovawart is a medium to large size German dog breed. The name of the breed means "an estate guard dog", which is the original use for the breed. The breed originated in the Black Forest region and was first described in text and paintings in medieval
      times.
    </div>
  </div>
</amp-carousel>

Linking Carousels with amp-bind

With amp-bind it's possible to link carousel state across multiple amp-carousels.

Whenever the carousel slide changes, it updates selectedSlide. This causes the text attribute in the <p> tag above the carousel to update as well.

Only whitelisted functions are allowed when using amp-bind. We use the unary plus operator before selectedSlide to cast it into an integer.

Example

Selected slide: 1/3

  <p> Selected slide:
    <span [text]="+selectedSlide + 1">1</span>/3</p>

  <amp-carousel controls
    type="slides"
    width="400"
    height="300"
    [slide]="selectedSlide"
    on="slideChange:AMP.setState({selectedSlide: event.index})">
    <amp-img src="/img/image1.jpg"
      width="400"
      height="300"></amp-img>
    <amp-img src="/img/image2.jpg"
      width="400"
      height="300"></amp-img>
    <amp-img src="/img/image3.jpg"
      width="400"
      height="300"></amp-img>
  </amp-carousel>

This and the following carousel are linked to each other and to the large carousel above. Notice how selecting an image on either of these two carousels changes the image on the top carousel.

In the first example, the CSS class for the selected image on the carousel is set by bind when selectedSlide changes.

Example

<amp-carousel controls
  width="400"
  height="100">
  <amp-img src="/img/image1.jpg"
    width="100"
    height="75"
    role="button"
    tabindex="0"
    [class]="selectedSlide == 0 ? 'selected' : ''"
    on="tap:AMP.setState({selectedSlide: 0})"></amp-img>
  <amp-img src="/img/image2.jpg"
    width="100"
    height="75"
    role="button"
    tabindex="1"
    [class]="selectedSlide == 1 ? 'selected' : ''"
    on="tap:AMP.setState({selectedSlide: 1})"></amp-img>
  <amp-img src="/img/image3.jpg"
    width="100"
    height="75"
    role="button"
    tabindex="2"
    [class]="selectedSlide == 2 ? 'selected' : ''"
    on="tap:AMP.setState({selectedSlide: 2})"></amp-img>
</amp-carousel>

In the second example, an amp-selector eliminates redundant code, but functions in the same way as the carousel above.

Example

<amp-selector layout="container"
  name="carousel-selector"
  [selected]="selectedSlide"
  on="select:AMP.setState({selectedSlide: event.targetOption})">
  <amp-carousel controls
    width="400"
    height="100">
    <amp-img src="/img/image1.jpg"
      width="100"
      height="75"
      option="0"></amp-img>
    <amp-img src="/img/image2.jpg"
      width="100"
      height="75"
      option="1"></amp-img>
    <amp-img src="/img/image3.jpg"
      width="100"
      height="75"
      option="2"></amp-img>
  </amp-carousel>
</amp-selector>

Collapsible Image Captions with amp-bind

Here is another workaround for image captions: expandable captions. The idea is to first show only the first line of a caption (using text-overflow: ellipsis;). When the user clicks on the caption, the caption is expanded to show the full text. This works by using amp-bind to toggle a CSS class expanded when the caption is clicked.

This sample uses the trick described here to ensure that images never overlap the caption. A positive side-effect is that image dimensions don't need to be known in advance either. This makes it a very flexible approach for an image carousel with images and captions of unknown size/length.

Example

Lorem ipsum dolor sit amet, consectetuer adipiscing elit. Aenean commodo ligula eget dolor. Aenean massa. Cum sociis natoque penatibus et magnis dis parturient montes, nascetur ridiculus mus. Donec quam felis, ultricies nec, pellentesque eu, pretium quis, sem. Nulla consequat massa quis enim. Donec pede justo, fringilla vel, aliquet nec, vulputate eget, arcu.
Lorem ipsum dolor sit amet, consectetuer adipiscing elit. Nulla consequat massa quis enim. Donec pede justo, fringilla vel, aliquet nec, vulputate eget, arcu.
Lorem ipsum dolor sit amet, consectetuer adipiscing elit. Aenean commodo ligula eget dolor. Aenean massa. Cum sociis natoque penatibus et magnis dis parturient montes, nascetur ridiculus mus. Donec quam felis, ultricies nec, pellentesque eu, pretium quis, sem. Lorem ipsum dolor sit amet, consectetuer adipiscing elit. Aenean commodo ligula eget dolor. Aenean massa. Cum sociis natoque penatibus et magnis dis parturient montes, nascetur ridiculus mus. Donec quam felis, ultricies nec, pellentesque eu, pretium quis, sem. Nulla consequat massa quis enim. Donec pede justo, fringilla vel, aliquet nec, vulputate eget, arcu.
<amp-carousel class="collapsible-captions"
  height="332"
  layout="fixed-height"
  type="slides">
  <figure>
    <div class="fixed-height-container">
      <amp-img layout="fill"
        src="https://unsplash.it/500/400"></amp-img>
    </div>
    <figcaption on="tap:AMP.setState({expanded: !expanded})"
      tabindex="0"
      role="button"
      [class]="expanded ? 'expanded' : ''">Lorem ipsum dolor sit amet, consectetuer adipiscing elit. Aenean commodo ligula eget dolor. Aenean massa. Cum sociis natoque penatibus et magnis dis parturient montes, nascetur ridiculus mus. Donec quam felis, ultricies nec, pellentesque eu, pretium
      quis, sem. Nulla consequat massa quis enim. Donec pede justo, fringilla vel, aliquet nec, vulputate eget, arcu.
      <span [text]="expanded ? '&#9660;' : '&#9650;'">&#9650;</span>
    </figcaption>
  </figure>
  <figure>
    <div class="fixed-height-container">
      <amp-img layout="fill"
        src="https://unsplash.it/500/500"></amp-img>
    </div>
    <figcaption on="tap:AMP.setState({expanded: !expanded})"
      tabindex="0"
      role="button"
      [class]="expanded ? 'expanded' : ''">Lorem ipsum dolor sit amet, consectetuer adipiscing elit. Nulla consequat massa quis enim. Donec pede justo, fringilla vel, aliquet nec, vulputate eget, arcu.
      <span [text]="expanded ? '&#9660;' : '&#9650;'">&#9650;</span>
    </figcaption>
  </figure>
  <figure>
    <div class="fixed-height-container">
      <amp-img layout="fill"
        src="https://unsplash.it/200/500"></amp-img>
    </div>
    <figcaption on="tap:AMP.setState({expanded: !expanded})"
      tabindex="0"
      role="button"
      [class]="expanded ? 'expanded' : ''">Lorem ipsum dolor sit amet, consectetuer adipiscing elit. Aenean commodo ligula eget dolor. Aenean massa. Cum sociis natoque penatibus et magnis dis parturient montes, nascetur ridiculus mus. Donec quam felis, ultricies nec, pellentesque eu, pretium
      quis, sem. Lorem ipsum dolor sit amet, consectetuer adipiscing elit. Aenean commodo ligula eget dolor. Aenean massa. Cum sociis natoque penatibus et magnis dis parturient montes, nascetur ridiculus mus. Donec quam felis, ultricies nec, pellentesque
      eu, pretium quis, sem. Nulla consequat massa quis enim. Donec pede justo, fringilla vel, aliquet nec, vulputate eget, arcu.
      <span [text]="expanded ? '&#9660;' : '&#9650;'">&#9650;</span>
    </figcaption>
  </figure>
</amp-carousel>

Image Galleries with Previews

You can reveal specific slides in carousel using an on tap action on="tap:my-carousel.goToSlide(index=0)". Slides are identified by the carousel id and index (starting at 0).

Example

  <amp-carousel id="carousel-with-preview"
    width="400"
    height="300"
    layout="responsive"
    type="slides">
    <amp-img src="https://unsplash.it/400/300?image=10"
      width="400"
      height="300"
      layout="responsive"
      alt="a sample image"></amp-img>
    <amp-img src="https://unsplash.it/400/300?image=11"
      width="400"
      height="300"
      layout="responsive"
      alt="a sample image"></amp-img>
    <amp-img src="https://unsplash.it/400/300?image=12"
      width="400"
      height="300"
      layout="responsive"
      alt="a sample image"></amp-img>
    <amp-img src="https://unsplash.it/400/300?image=13"
      width="400"
      height="300"
      layout="responsive"
      alt="a sample image"></amp-img>
  </amp-carousel>
  <div class="carousel-preview">
    <button on="tap:carousel-with-preview.goToSlide(index=0)">
      <amp-img src="https://unsplash.it/60/40?image=10"
        width="60"
        height="40"
        layout="responsive"
        alt="a sample image"></amp-img>
    </button>
    <button on="tap:carousel-with-preview.goToSlide(index=1)">
      <amp-img src="https://unsplash.it/60/40?image=11"
        width="60"
        height="40"
        layout="responsive"
        alt="a sample image"></amp-img>
    </button>
    <button on="tap:carousel-with-preview.goToSlide(index=2)">
      <amp-img src="https://unsplash.it/60/40?image=12"
        width="60"
        height="40"
        layout="responsive"
        alt="a sample image"></amp-img>
    </button>
    <button on="tap:carousel-with-preview.goToSlide(index=3)">
      <amp-img src="https://unsplash.it/60/40?image=13"
        width="60"
        height="40"
        layout="responsive"
        alt="a sample image"></amp-img>
    </button>
  </div>

You can even use a second carousel for the preview if a carousel contains a large number of images (make sure to use the type=carousel for the second one).

Example

  <amp-carousel id="carousel-with-carousel-preview"
    width="400"
    height="300"
    layout="responsive"
    type="slides">
    <amp-img src="https://unsplash.it/400/300?image=10"
      width="400"
      height="300"
      layout="responsive"
      alt="a sample image"></amp-img>
    <amp-img src="https://unsplash.it/400/300?image=11"
      width="400"
      height="300"
      layout="responsive"
      alt="a sample image"></amp-img>
    <amp-img src="https://unsplash.it/400/300?image=12"
      width="400"
      height="300"
      layout="responsive"
      alt="a sample image"></amp-img>
    <amp-img src="https://unsplash.it/400/300?image=13"
      width="400"
      height="300"
      layout="responsive"
      alt="a sample image"></amp-img>
    <amp-img src="https://unsplash.it/400/300?image=14"
      width="400"
      height="300"
      layout="responsive"
      alt="a sample image"></amp-img>
    <amp-img src="https://unsplash.it/400/300?image=15"
      width="400"
      height="300"
      layout="responsive"
      alt="a sample image"></amp-img>
    <amp-img src="https://unsplash.it/400/300?image=16"
      width="400"
      height="300"
      layout="responsive"
      alt="a sample image"></amp-img>
    <amp-img src="https://unsplash.it/400/300?image=17"
      width="400"
      height="300"
      layout="responsive"
      alt="a sample image"></amp-img>
    <amp-img src="https://unsplash.it/400/300?image=18"
      width="400"
      height="300"
      layout="responsive"
      alt="a sample image"></amp-img>
    <amp-img src="https://unsplash.it/400/300?image=19"
      width="400"
      height="300"
      layout="responsive"
      alt="a sample image"></amp-img>
    <amp-img src="https://unsplash.it/400/300?image=110"
      width="400"
      height="300"
      layout="responsive"
      alt="a sample image"></amp-img>
    <amp-img src="https://unsplash.it/400/300?image=111"
      width="400"
      height="300"
      layout="responsive"
      alt="a sample image"></amp-img>
    <amp-img src="https://unsplash.it/400/300?image=112"
      width="400"
      height="300"
      layout="responsive"
      alt="a sample image"></amp-img>
    <amp-img src="https://unsplash.it/400/300?image=113"
      width="400"
      height="300"
      layout="responsive"
      alt="a sample image"></amp-img>
    <amp-img src="https://unsplash.it/400/300?image=114"
      width="400"
      height="300"
      layout="responsive"
      alt="a sample image"></amp-img>
    <amp-img src="https://unsplash.it/400/300?image=115"
      width="400"
      height="300"
      layout="responsive"
      alt="a sample image"></amp-img>
    <amp-img src="https://unsplash.it/400/300?image=116"
      width="400"
      height="300"
      layout="responsive"
      alt="a sample image"></amp-img>
    <amp-img src="https://unsplash.it/400/300?image=117"
      width="400"
      height="300"
      layout="responsive"
      alt="a sample image"></amp-img>
  </amp-carousel>
  <amp-carousel class="carousel-preview"
    width="auto"
    height="48"
    layout="fixed-height"
    type="carousel">
    <button on="tap:carousel-with-carousel-preview.goToSlide(index=0)">
      <amp-img src="https://unsplash.it/60/40?image=10"
        width="60"
        height="40"
        layout="responsive"
        alt="a sample image"></amp-img>
    </button>
    <button on="tap:carousel-with-carousel-preview.goToSlide(index=1)">
      <amp-img src="https://unsplash.it/60/40?image=11"
        width="60"
        height="40"
        layout="responsive"
        alt="a sample image"></amp-img>
    </button>
    <button on="tap:carousel-with-carousel-preview.goToSlide(index=2)">
      <amp-img src="https://unsplash.it/60/40?image=12"
        width="60"
        height="40"
        layout="responsive"
        alt="a sample image"></amp-img>
    </button>
    <button on="tap:carousel-with-carousel-preview.goToSlide(index=3)">
      <amp-img src="https://unsplash.it/60/40?image=13"
        width="60"
        height="40"
        layout="responsive"
        alt="a sample image"></amp-img>
    </button>
    <button on="tap:carousel-with-carousel-preview.goToSlide(index=4)">
      <amp-img src="https://unsplash.it/60/40?image=14"
        width="60"
        height="40"
        layout="responsive"
        alt="a sample image"></amp-img>
    </button>
    <button on="tap:carousel-with-carousel-preview.goToSlide(index=5)">
      <amp-img src="https://unsplash.it/60/40?image=15"
        width="60"
        height="40"
        layout="responsive"
        alt="a sample image"></amp-img>
    </button>
    <button on="tap:carousel-with-carousel-preview.goToSlide(index=6)">
      <amp-img src="https://unsplash.it/60/40?image=16"
        width="60"
        height="40"
        layout="responsive"
        alt="a sample image"></amp-img>
    </button>
    <button on="tap:carousel-with-carousel-preview.goToSlide(index=7)">
      <amp-img src="https://unsplash.it/60/40?image=17"
        width="60"
        height="40"
        layout="responsive"
        alt="a sample image"></amp-img>
    </button>
    <button on="tap:carousel-with-carousel-preview.goToSlide(index=8)">
      <amp-img src="https://unsplash.it/60/40?image=18"
        width="60"
        height="40"
        layout="responsive"
        alt="a sample image"></amp-img>
    </button>
    <button on="tap:carousel-with-carousel-preview.goToSlide(index=9)">
      <amp-img src="https://unsplash.it/60/40?image=19"
        width="60"
        height="40"
        layout="responsive"
        alt="a sample image"></amp-img>
    </button>
    <button on="tap:carousel-with-carousel-preview.goToSlide(index=10)">
      <amp-img src="https://unsplash.it/60/40?image=110"
        width="60"
        height="40"
        layout="responsive"
        alt="a sample image"></amp-img>
    </button>
    <button on="tap:carousel-with-carousel-preview.goToSlide(index=11)">
      <amp-img src="https://unsplash.it/60/40?image=111"
        width="60"
        height="40"
        layout="responsive"
        alt="a sample image"></amp-img>
    </button>
    <button on="tap:carousel-with-carousel-preview.goToSlide(index=12)">
      <amp-img src="https://unsplash.it/60/40?image=112"
        width="60"
        height="40"
        layout="responsive"
        alt="a sample image"></amp-img>
    </button>
    <button on="tap:carousel-with-carousel-preview.goToSlide(index=13)">
      <amp-img src="https://unsplash.it/60/40?image=113"
        width="60"
        height="40"
        layout="responsive"
        alt="a sample image"></amp-img>
    </button>
    <button on="tap:carousel-with-carousel-preview.goToSlide(index=14)">
      <amp-img src="https://unsplash.it/60/40?image=114"
        width="60"
        height="40"
        layout="responsive"
        alt="a sample image"></amp-img>
    </button>
    <button on="tap:carousel-with-carousel-preview.goToSlide(index=15)">
      <amp-img src="https://unsplash.it/60/40?image=115"
        width="60"
        height="40"
        layout="responsive"
        alt="a sample image"></amp-img>
    </button>
    <button on="tap:carousel-with-carousel-preview.goToSlide(index=16)">
      <amp-img src="https://unsplash.it/60/40?image=116"
        width="60"
        height="40"
        layout="responsive"
        alt="a sample image"></amp-img>
    </button>
    <button on="tap:carousel-with-carousel-preview.goToSlide(index=17)">
      <amp-img src="https://unsplash.it/60/40?image=117"
        width="60"
        height="40"
        layout="responsive"
        alt="a sample image"></amp-img>
    </button>
  </amp-carousel>

Metadata

The Top Stories carousel requires schema.org markup for one of the following types: Article, NewsArticle, BlogPosting, or VideoObject. If your Image Gallery is also a NewsArticle, you may want to mark it up as such:

  <script type="application/ld+json">
[
  {
    "@context": "http://schema.org",
    "@type": "NewsArticle",
    ...
  },
  {
    "@context": "http://schema.org",
    "@type": "ImageGallery",
    "associatedMedia": [
      {
        "@context": "http://schema.org",
        "@type": "ImageObject",
        "contentUrl": "https://unsplash.it/60/40?image=1",
        "caption": "A cute pup"
      },
      {,
        "@context": "http://schema.org",
        "@type": "ImageObject",
        "contentUrl": "https://unsplash.it/60/40?image=2",
        "caption": "A doubly cute pup"
      },
    ],
  }
]
  </script>