Product Tour

Attributes

The Product Tour, as an extension of the 3D Viewer, shares many of its attributes. For reference, please visit this page.

AttributeTypeDefaultDescription
product-tour-visiblebooleanfalsesets visibility of the Product Tour
suppress-tour-modalbooleanfalsesets ability to suppress the Product Tour side panel on mobile devices

Attribute Example

This example shows how to use the sku, viewer-visible, and product-tour-visible attributes:

<epigraph-ar
	sku="INSERT-SKU"
	viewer-visible
	product-tour-visible
></epigraph-ar>

CSS Custom Properties

PropertyDescription
--hotspot-button-background-coloredits hotspot button background color
--hotspot-button-border-coloredits hotspot button border color
--hotspot-button-focus-border-coloredits hotspot button border color when focused
--hotspot-inner-circle-border-coloredits hotspot button inner circle border color
--hotspot-inner-circle-viewed-border-coloredits hotspot button inner circle border color when viewed
--mobile-product-tour-button-background-coloredits product-tour mobile button background color
--mobile-product-tour-button-text-coloredits product-tour mobile button text color
--product-tour-background-coloredits product-tour background color
--product-tour-close-button-fill-coloredits product-tour close button fill color
--product-tour-close-button-hover-fill-coloredits product-tour close button fill color when hovered
--product-tour-close-button-hover-stroke-coloredits product-tour close-button stroke color when hovered
--product-tour-close-button-stroke-coloredits product-tour close-button stroke color
--product-tour-current-dot-background-coloredits product-tour control dot background color when it points to a current image
--product-tour-dot-background-coloredits product-tour control dot background color
--product-tour-mobile-close-button-outline-coloredits product-tour mobile close button outline color
--product-tour-mobile-close-button-stroke-coloredits product-tour mobile close button stroke color

CSS Custom Property Example

This example sets the hotspot button background color custom property to blue:

epigraph-ar {
     --hotspot-button-background-color: blue;
 }

CSS Shadow Parts

PartDescription
hotspot-buttonpoints to the hotspot button
hotspot-button-annotationpoints to the hotspot button annotation
hotspot-button-inner-circlepoints to the inner circle of the hotspot button
mobile-product-tour-button-defaultpoints to the default mobile Product Tour launch button
product-tourpoints to the <product-tour> element
product-tour-carousel-mediapoints to the media housed inside the side panel carousel
product-tour-close-containerpoints to the close button inside the side panel
product-tour-close-defaultpoints to the default close button inside the side panel
product-tour-containerpoints to the side panel container
product-tour-feature-content-containerpoints to the feature content container inside the side panel
product-tour-feature-descriptionpoints to the description of the feature text inside the side panel
product-tour-feature-media-containerpoints to the containers housing feature media inside the side panel
product-tour-feature-text-containerpoints to the containers housing the feature text inside the side panel
product-tour-feature-titlepoints to the title of the feature text
product-tour-content-containerpoints to the inner content container inside the side panel
product-tour-media-carouselpoints to the feature media carousels inside the side panel
product-tour-media-carousel-dotpoints to the control buttons for the media carousels inside the side panel
product-tour-media-controls-containerpoints to the containers housing the control buttons for the media carousels inside the side panel
product-tour-media-titlepoints to the feature media titles inside the side panel

CSS Shadow Part Example

This example sets the opacity of the hotspot button CSS shadow part to 0.5:

epigraph-ar::part(hotspot-button) {
  opacity: 0.5;
}

Slots

SlotDescription
mobile-product-tour-buttonreplaces the mobile Product Tour launch button
viewer-modal-exit-buttonreplaces the mobile fullscreen exit button

Slot Example

This example sets the mobile-product-tour-button slot to a new button element:

<epigraph-ar>
     <button slot="mobile-product-tour-button"></button>
</epigraph-ar>

Events

EventTypeDescription
product-tour-requestedCustomEvent<{hotspotData: any; firingEvent: any;}>custom event to bubble up launching a hotspot if the suppress-tour-modal attribute is enabled

Event Usage Example

This example listens for the product-tour-requested event on the first instance of epigraph-ar on your page, provided that the suppress-tour-modal attribute is enabled:

let arElement = document.querySelector('epigraph-ar');
arElement.addEventListener('product-tour-requested', (e) => {
  console.log('Product Tour requested');
});

Methods

MethodTypeDescription
collapse():voidpublic method to collapse the Product Tour side panel

Method Usage Example

This example shows how to call the collapse method on the Product Tour element within the shadow root of the first instance of epigraph-ar on your page:

<script>
  let arElement = document.querySelector('epigraph-ar');
	let tourElement = arElement.shadowRoot.querySelector('product-tour');
	tourElement.collapse();
</script>