amp-dynamic-css-classes

Edit on Github
Open in Playground

Introduction

AMP's dynamic CSS classes provided by the amp-dynamic-css-class tag enable boolean logic for a handful of conditions

Setup

Include the amp-dynamic-css-classes extended component.

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

For the purpose of this sample, we're creating some helper CSS classes that use the CSS rules defined by amp-dynamic-css-classes. These allow us to more succinctly refer to the conditions in our code below.

<style amp-custom>
  body:not(.amp-referrer-pinterest-com) .if-pinterest, 
  body:not(.amp-referrer-ampbyexample-com) .if-ampbyexample, 
  body:not(.amp-referrer-google-com) .if-google,
  body:not(.amp-referrer-twitter-com) .if-twitter,
  body:not(.amp-referrer-linkedin-com) .if-linkedin,
  body:not(.amp-referrer-localhost) .if-localhost {
    display: none;
  }
  body:not(.amp-viewer) .if-viewer,
  body.amp-viewer .if-not-viewer {
    display: none;
  }
  p {
    padding: 1rem;
  }
</style>

You do not need to include a call to the amp-dynamic-css-classes component to initialize the classes on the body element

Referrer

Using these referrer classes can allow you to conditionally include elements.

Example

You were referred here or embedded by Pinterest!

You were referred here or embedded by Twitter!

You were referred here or embedded by Google!

You came here directly! Cool :)

You came here directly! Cool :)

  <p class="if-pinterest">You were referred here or embedded by Pinterest!</p>
  <p class="if-twitter">You were referred here or embedded by Twitter!</p>
  <p class="if-google">You were referred here or embedded by Google!</p>
  <p class="if-ampbyexample">You came here directly! Cool :)</p>
  <p class="if-localhost">You came here directly! Cool :)</p>

Viewer

The 'viewer' classes enable you to style the page based on whether it's embedded inside an AMP viewer. Try it out on the Google AMP Viewer:

Example

Hey! You're not visiting within the context of an AMP Viewer!

Ahoy! Since you're coming from a viewer.

  <p class="if-not-viewer">Hey! You're not visiting within the context of an AMP Viewer!</p>
  <p class="if-viewer">Ahoy! Since you're coming from a viewer.</p>