Carousel carousel

Carousel Viewer är ett visningsprogram som visar en karusell med icke-zoombara banderollbilder med klickbara hotspot-områden. Det här visningsprogrammet kan hjälpa dig att implementera en shoppingupplevelse där användarna kan välja en hotspot eller ett område över banderollbilden. De kan omdirigeras till en Quickview- eller produktinformationssida på kundens webbplats. Den är utformad för att fungera på stationära datorer och mobila enheter.

NOTE
Bilder som använder bildåtergivning eller användargenererat innehåll (UGC) stöds inte av det här visningsprogrammet.

Visningstypen är 511.

Demo-URL section-c0ad383db6a444979dc7eeb1ec4cf54d

https://experienceleague.adobe.com/tools/dynamic-media-demo/viewers-ref/carousel/CarouselViewerDemo.html?lang=sv-SE

Systemkrav section-b7270cc4290043399681dc504f043609

Se Systemkrav.

Carousel Viewer representerar en JavaScript-huvudfil och en uppsättning hjälpfiler (en enda JavaScript-fil innehåller alla SDK-komponenter för visningsprogrammet som används av det här visningsprogrammet, resurser, CSS) som hämtats av visningsprogrammet under körning.

Carousel Viewer kan användas både i popup-läge med en produktionsklar HTML-sida som finns i IS Viewer, eller i inbäddat läge där den integreras med målwebbsidan med hjälp av dokumenterad API.

Konfigurationen och skalningen liknar den för andra visningsprogram som beskrivs i den här hjälpen. All skalning görs med anpassad CSS.

Se Kommandoreferens som är gemensam för alla visningsprogram - Konfigurationsattribut och Kommandoreferens som är gemensam för alla visningsprogram - URL

Du kan navigera genom karuselluppsättningen genom att svepa vågrätt över huvudvyn eller genom att använda två pilknappar på den stationära datorn. Ange indikatorpunkter visar den aktuella positionen inom uppsättningen.

Visningsprogrammet kan återge aktiveringspunkter eller områden ovanpå banderollbilden för att indikera det interaktiva området i produkten.

Om du klickar eller trycker på en hotspot eller ett område utlöses en åtgärd som är kopplad till den under redigeringstiden. Åtgärden kan omdirigeras till en annan sida på webbplatsen eller skickas tillbaka produktinformation till webbsidans logik, som i sin tur kan utlösa en snabbvy med relaterat produktinnehåll.

Visningsprogrammet är fullt åtkomligt via tangentbordet.

Se Tangentbordstillgänglighet och navigering.

Om popup-läge

I popup-läge öppnas visningsprogrammet i ett separat webbläsarfönster eller på en separat flik. Det tar hela webbläsarfönsterområdet och justeras om webbläsaren ändrar storlek eller om en mobilenhets orientering ändras.

Popup-läget är det vanligaste för mobila enheter. Webbsidan läser in visningsprogrammet med window.open() JavaScript-anrop, korrekt konfigurerat A HTML-element eller någon annan lämplig metod.

Vi rekommenderar att du använder en färdig HTML-sida för popup-läge. I det här fallet kallas den CarouselViewer.html och finns i undermappen html5/ i din standarddistribution av IS-Viewer:

<s7viewers_root>/html5/CarouselViewer.html

Du kan anpassa visuellt genom att använda anpassad CSS.

Här följer ett exempel på HTML som öppnar visningsprogrammet i ett nytt fönster:

<a href="https://demos-pub.assetsadobe.com/etc/dam/viewers/s7viewers/html5/CarouselViewer.html?asset=/content/dam/dm-public-facing-live-demo-page/04_shoppable_carousel/05_shoppable_banner&serverurl=https://adobedemo62-h.assetsadobe.com/is/image" target="_blank">Open popup viewer</a>

Om inbäddningsläge med fast storlek och inbäddningsläge för responsiv design

I det inbäddade läget läggs visningsprogrammet till på den befintliga webbsidan. Den här webbsidan kanske redan har kundinnehåll som inte är relaterat till visningsprogrammet. Visningsprogrammet tar normalt bara upp en del av en webbsidas fastighet.

De viktigaste användningsområdena är webbsidor som är orienterade för datorer eller surfplattor, och responsiva designade sidor som automatiskt anpassar layouten beroende på enhetstyp.

Inbäddning med fast storlek används när visningsprogrammet inte ändrar sin storlek efter den första inläsningen. Den här metoden är det bästa alternativet för webbsidor som har en statisk layout.

Inbäddning av responsiv design förutsätter att visningsprogrammet måste ändra storlek vid körning som svar på storleksändringen för behållaren DIV. Det vanligaste användningsområdet är att lägga till ett visningsprogram på en webbsida som använder en flexibel sidlayout.

I läget responsiv designinbäddning beter sig visningsprogrammet olika beroende på hur webbsidan ändrar storleken på behållaren DIV. Om webbsidan bara anger bredden på behållaren DIV, och dess höjd inte begränsas, väljer visningsprogrammet automatiskt höjden enligt proportionerna för resursen som används. Med den här funktionen kan du vara säker på att resursen passar perfekt in i vyn utan utfyllnad på sidorna. Det här användningsexemplet är det vanligaste för webbsidor med flexibla ramverk för webbdesign som Bootstrap och Foundation.

Om webbsidan ställer in både bredd och höjd för visningsprogrammets behållare DIV fyller visningsprogrammet bara det området. Den har också samma storlek som webbsideslayouten. Ett bra exempel är att bädda in visningsprogrammet i en modal övertäckning, där storleken på övertäckningen anpassas efter webbläsarens fönsterstorlek.

Inbäddning med fast storlek

Du lägger till visningsprogrammet på en webbsida genom att göra följande:

  1. Lägga till visningsprogrammets JavaScript-fil på webbsidan.

  2. Definierar behållaren DIV.

  3. Anger visningsprogrammets storlek.

  4. Skapa och initiera visningsprogrammet.

  5. Lägga till visningsprogrammets JavaScript-fil på webbsidan.

    Om du vill skapa ett visningsprogram måste du lägga till en script-tagg i huvudet HTML. Innan du kan använda visningsprogrammets API måste du ta med CarouselViewer.js. Filen CarouselViewer.js finns under undermappen html5/js/ i din standarddistribution av IS-Viewer:

<s7viewers_root>/etc/dam/viewers/s7viewers/html5/js/CarouselViewer.js

Du kan använda en relativ sökväg om visningsprogrammet distribueras på någon av Adobe Dynamic Media Classic-servrarna och den hanteras från samma domän. Annars anger du en fullständig sökväg till en av Adobe Dynamic Media Classic-servrarna som har IS-Viewer installerat.

Den relativa sökvägen ser ut så här:

<script language="javascript" type="text/javascript" src="/etc/dam/viewers/s7viewers/html5/js/CarouselViewer.js"></script>
NOTE
Referera bara till JavaScript include-huvudvisningsfilen på din sida. Referera inte till några andra JavaScript-filer i webbsideskoden som kan hämtas av visningsprogrammets logik under körning. Referera inte direkt till HTML5 SDK Utils.js-biblioteket som läses in av visningsprogrammet från kontextsökvägen /s7viewers (s.k. konsoliderad SDK include). Orsaken är att platsen för Utils.js eller liknande visningsprogrambibliotek för miljön hanteras helt av visningsprogrammets logik och platsen ändras mellan visningsprogramversioner. Adobe sparar inte äldre versioner av det sekundära visningsprogrammet includes på servern.
Det innebär att om du skickar en direkt referens till eventuella sekundära JavaScript include som används av visningsprogrammet på sidan så bryts visningsprogrammets funktioner i framtiden när en ny produktversion distribueras.
  1. Definierar behållaren DIV.

    Lägg till ett tomt DIV-element på sidan där du vill att visningsprogrammet ska visas. Elementet DIV måste ha sitt ID definierat eftersom detta ID skickas senare till visningsprogrammets API. DIV har den storlek som anges via CSS.

    Platshållaren DIV är ett placerat element, vilket innebär att CSS-egenskapen position är inställd på relative eller absolute.

    Följande är ett exempel på ett definierat platshållarelement DIV:

    code language-css
    <div id="s7viewer" style="position:relative"></div>
    
  2. Ange visningsprogrammets storlek

    Du kan ange den statiska storleken för visningsprogrammet genom att antingen deklarera den för CSS-klassen .s7carouselviewer på den översta nivån i absoluta enheter eller genom att använda modifieraren stagesize.

    Du kan ange storlek i CSS direkt på HTML-sidan. Du kan också lägga in storleksändring i en anpassad CSS-fil för visningsprogrammet, som sedan tilldelas en post för visningsförinställningar i AEM Assets - On-demand, eller skickas explicit med kommandot style.

    Mer information om hur du formaterar visningsprogrammet med CSS finns i Anpassa Carousel Viewer.

    Följande är ett exempel på hur du definierar en statisk visningsstorlek på HTML-sidan:

    code language-css
    #s7viewer.s7carouselviewer {
     width: 1174px;
     height: 500px;
    }
    

    Du kan skicka modifieraren stagesize explicit med initieringskoden för visningsprogrammet med samlingen params eller som ett API-anrop enligt beskrivningen i avsnittet Command Reference, så här:

    code language-css
    carouselViewer.setParam("stagesize", "1174,500");
    

    En CSS-baserad metod rekommenderas och används i det här exemplet.

  3. Skapa och initiera visningsprogrammet.

    När du har slutfört stegen ovan skapar du en instans av klassen s7viewers.CarouselViewer, skickar all konfigurationsinformation till konstruktorn och anropar metoden init() för en visningsprograminstans. Konfigurationsinformation skickas till konstruktorn som ett JSON-objekt. Det här objektet ska åtminstone ha fältet containerId som innehåller namnet på visningsbehållar-ID och det kapslade JSON-objektet params med konfigurationsparametrar som stöds av visningsprogrammet. I det här fallet måste objektet params ha minst URL:en för bildservrar som skickas som egenskapen serverUrl och den ursprungliga resursen som parametern asset. Med det JSON-baserade initierings-API:t kan du skapa och starta visningsprogrammet med en enda kodrad.

    Det är viktigt att lägga till visningsprogrambehållaren i DOM så att visningsprogramkoden kan hitta behållarelementet med dess ID. I vissa webbläsare fördröjs skapandet av DOM tills webbsidan är slut. För maximal kompatibilitet anropar du metoden init() precis före den avslutande BODY -taggen eller på body onload() -händelsen.

    Samtidigt behöver behållarelementet inte nödvändigtvis vara en del av webbsidans layout ännu. Den kan till exempel vara dold med formatet display:none som tilldelats den. I det här fallet skjuter visningsprogrammet upp initieringsprocessen tills webbsidan återför behållarelementet till layouten. När den här funktionaliteten inträffar återgår visningsprogrammet automatiskt.

    Följande är ett exempel på hur du skapar en visningsprograminstans, skickar nödvändiga minimikonfigurationsalternativ till konstruktorn och anropar metoden init(). Exemplet förutsätter att carouselViewer är visningsprograminstansen; s7viewer är namnet på platshållaren DIV; https://adobedemo62-h.assetsadobe.com/is/image är URL:en för bildhantering och /content/dam/dm-public-facing-live-demo-page/04_shoppable_carousel/05_shoppable_banner är resursen:

    code language-javascript
    <script type="text/javascript">
    var carouselViewer = new s7viewers.CarouselViewer ({
     "containerId":"s7viewer",
    "params":{
     "asset":"/content/dam/dm-public-facing-live-demo-page/04_shoppable_carousel/05_shoppable_banner",
     "serverurl":"https://adobedemo62-h.assetsadobe.com/is/image"
    }
    }).init();
    </script>
    

    Följande kod är ett komplett exempel på en enkel webbsida som bäddar in Carousel Viewer med fast storlek:

    code language-html
    <!DOCTYPE html>
    <html>
    <head>
    <script type="text/javascript" src="https://demos-pub.assetsadobe.com/etc/dam/viewers/s7viewers/html5/js/CarouselViewer.js"></script>
    <style type="text/css">
    #s7viewer.s7carouselviewer {
     width: 1174px;
     height: 500px;
    }
    </style>
    </head>
    <body>
    <div id="s7viewer" style="position:relative"></div>
    <script type="text/javascript">
    var carouselViewer = new s7viewers.CarouselViewer({
     "containerId":"s7viewer",
    "params":{
     "asset":"/content/dam/dm-public-facing-live-demo-page/04_shoppable_carousel/05_shoppable_banner",
     "serverurl":"https://adobedemo62-h.assetsadobe.com/is/image"
    }
    }).init();
    </script>
    </body>
    </html>
    

Responsiv designinbäddning med obegränsad höjd

Med responsiv designinbäddning har webbsidan vanligtvis någon typ av flexibel layout på plats som bestämmer körningsstorleken för visningsprogrammets behållare DIV. I följande exempel antar du att webbsidan tillåter att visningsprogrammets behållare DIV tar 40 % av webbläsarens fönsterstorlek. Och höjden är obegränsad. Webbsidans HTML-kod ser ut så här:

<!DOCTYPE html>
<html>
<head>
<style type="text/css">
.holder {
 width: 80%;
}
</style>
</head>
<body>
<div class="holder"></div>
</body>
</html>

Att lägga till visningsprogrammet på en sådan sida liknar stegen för inbäddning med fast storlek. Den enda skillnaden är att du inte behöver definiera visningsprogrammets storlek explicit.

  1. Lägga till visningsprogrammets JavaScript-fil på webbsidan.
  2. Definierar behållaren DIV.
  3. Skapa och initiera visningsprogrammet.

Alla steg ovan är desamma som med inbäddning med fast storlek. Lägg till behållaren DIV i den befintliga "holder" DIV. Följande kod är ett komplett exempel. Lägg märke till hur visningsprogrammets storlek ändras när webbläsarens storlek ändras och hur visningsprogrammets proportioner matchar resursen.

<!DOCTYPE html>
<html>
<head>
<script type="text/javascript" src="https://demos-pub.assetsadobe.com/etc/dam/viewers/s7viewers/html5/js/CarouselViewer.js"></script>
<style type="text/css">
.holder {
 width: 80%;
}
</style>
</head>
<body>
<div class="holder">
<div id="s7viewer" style="position:relative"></div>
</div>
<script type="text/javascript">
var carouselViewer = new s7viewers.CarouselViewer({
 "containerId":"s7viewer",
"params":{
 "asset":"/content/dam/dm-public-facing-live-demo-page/04_shoppable_carousel/05_shoppable_banner",
 "serverurl":"https://adobedemo62-h.assetsadobe.com/is/image"
}
}).init();
</script>
</body>
</html>

Följande exempelsida visar mer verkliga användningsområden för responsiv designinbäddning med obegränsad höjd:

https://experienceleague.adobe.com/tools/dynamic-media-demo/viewers-ref/carousel/CarouselViewer-responsive-unrestricted-height.html?lang=sv-SE

Bädda in i flexibel storlek med definierad bredd och höjd

Vid inbäddning i flexibel storlek med definierad bredd och höjd är webbsidans format annorlunda. Den ger DIV:n "holder" båda storlekar och centrerar den i webbläsarfönstret. Webbsidan anger också storleken på elementen HTML och BODY till 100 procent.

<!DOCTYPE html>
<html>
<head>
<style type="text/css">
html, body {
 width: 100%;
 height: 100%;
}
.holder {
 position: absolute;
 left: 20%;
 top: 20%;
 width: 60%;
height: 60%;
}
</style>
</head>
<body>
<div class="holder"></div>
</body>
</html>

Resten av inbäddningsstegen är identiska med stegen som används för responsiv inbäddning med obegränsad höjd. Följande exempel visas:

<!DOCTYPE html>
<html>
<head>
<script type="text/javascript" src="https://demos-pub.assetsadobe.com/etc/dam/viewers/s7viewers/html5/js/CarouselViewer.js"></script>
<style type="text/css">
html, body {
 width: 100%;
 height: 100%;
}
.holder {
 position: absolute;
 left: 20%;
 top: 20%;
 width: 60%;
height: 60%;
}
</style>
</head>
<body>
<div class="holder">
<div id="s7viewer" style="position:relative"></div>
</div>
<script type="text/javascript">
var carouselViewer = new s7viewers.CarouselViewer({
 "containerId":"s7viewer",
"params":{
 "asset":"/content/dam/dm-public-facing-live-demo-page/04_shoppable_carousel/05_shoppable_banner",
 "serverurl":"https://adobedemo62-h.assetsadobe.com/is/image"
}
}).init();
</script>
</body>
</html>

Bädda in med Setter-baserat API

I stället för att använda JSON-baserad initiering kan du använda set-based API och no-args-konstruktor. Om du använder den här API-konstruktorn används inga parametrar och konfigurationsparametrar anges med API-metoderna setContainerId(), setParam() och setAsset() med separata JavaScript-anrop.

I följande exempel visas hur du använder inbäddning med fast storlek med det inställningsbaserade API

<!DOCTYPE html>
<html>
<head>
<script type="text/javascript" src="https://demos-pub.assetsadobe.com/etc/dam/viewers/s7viewers/html5/js/CarouselViewer.js"></script>
<style type="text/css">
#s7viewer.s7carouselviewer {
 width: 1174px;
 height: 500px;
}
</style>
</head>
<body>
<div id="s7viewer" style="position:relative"></div>
<script type="text/javascript">
var carouselViewer = new s7viewers.CarouselViewer();
carouselViewer.setContainerId("s7viewer");
carouselViewer.setParam("serverurl", "https://adobedemo62-h.assetsadobe.com/is/image");
carouselViewer.setAsset("/content/dam/dm-public-facing-live-demo-page/04_shoppable_carousel/05_shoppable_banner");
carouselViewer.init();
</script>
</body>
</html>
recommendation-more-help
b7426f53-aad9-4c00-83fc-664f30f681e8