Carousel carousel

Carousel Viewer is een viewer die een carrousel van niet-zoombare bannerafbeeldingen weergeeft met klikbare hotspots of gebieden. Met deze viewer kunt u een "schokkende carrousel"-ervaring implementeren waarmee gebruikers een hotspot of een gebied boven de bannerafbeelding kunnen selecteren. Ze kunnen worden omgeleid naar een pagina met Quickview- of productdetails op de website van de klant. Het is ontworpen voor gebruik op desktops en mobiele apparaten.

NOTE
Afbeeldingen die gebruikmaken van Afbeeldingen renderen of Door de gebruiker gegenereerde inhoud (UGC) worden niet ondersteund door deze viewer.

Het viewertype is 511.

Demo-URL section-c0ad383db6a444979dc7eeb1ec4cf54d

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

Systeemvereisten section-b7270cc4290043399681dc504f043609

Zie vereisten van het Systeem.

De Carousel Viewer vertegenwoordigt een JavaScript-hoofdbestand en een set helperbestanden (één JavaScript-bestand met alle SDK-componenten van de Viewer die door deze viewer worden gebruikt, elementen, CSS) die door de viewer in runtime zijn gedownload.

De Carousel Viewer kan zowel in pop-upmodus worden gebruikt met een HTML-pagina die klaar is voor productie en die bij IS Viewers wordt geleverd, als in de ingesloten modus waarin deze viewer met behulp van gedocumenteerde API in de doelwebpagina wordt geïntegreerd.

Configuratie en skins zijn vergelijkbaar met die van de andere viewers die in deze Help worden beschreven. Alle skins worden gemaakt door middel van aangepaste CSS.

Zie verwijzing van het Bevel gemeenschappelijk aan alle kijkers - de attributen van de Configuratieen verwijzing van het Bevel gemeenschappelijk aan alle Kijkers - URL

U kunt door de carrouselset navigeren met een horizontale veegbeweging over de hoofdweergave of met twee pijlknoppen op het desktopapparaat. De vastgestelde indicatorpunten tonen de huidige positie binnen de reeks.

De viewer kan hotspots of gebieden boven op de bannerafbeelding renderen om het interactieve gebied van het product aan te geven.

Wanneer u op een hotspot of gebied klikt of erop tikt, wordt tijdens de auteurstijd een bijbehorende handeling geactiveerd. De handeling kan worden omgeleid naar een andere pagina op de website of de productinformatie kan worden teruggestuurd naar de webpaginalogica, die op zijn beurt weer een QuickView met verwante productinhoud kan activeren.

De viewer is volledig toegankelijk via het toetsenbord.

Zie toegankelijkheid van het Toetsenbord en navigatie.

Ongeveer pop-up wijze

In de pop-upmodus wordt de viewer geopend in een apart venster of tabblad van een webbrowser. Het neemt het volledige browservenstergebied en past zich aan voor het geval de browser wordt aangepast of de oriëntatie van een mobiel apparaat wordt gewijzigd.

Pop-upmodus is de meest gebruikte voor mobiele apparaten. De webpagina laadt de viewer met window.open() JavaScript-aanroep, correct geconfigureerd A HTML-element of een andere geschikte methode.

Het wordt aanbevolen een HTML-pagina uit de doos te gebruiken voor de pop-upbewerkingsmodus. In dit geval wordt deze aangeroepen CarouselViewer.html en bevindt deze zich in de submap html5/ van uw standaard IS-Viewers-implementatie:

<s7viewers_root>/html5/CarouselViewer.html

U kunt visuele aanpassing bereiken door aangepaste CSS toe te passen.

Hieronder ziet u een voorbeeld van HTML-code waarmee de viewer in een nieuw venster wordt geopend:

<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>

Ongeveer vaste grootte inbeddende wijze en ontvankelijke ontwerp het inbedden wijze

In de ingesloten modus wordt de viewer toegevoegd aan de bestaande webpagina. Deze webpagina heeft mogelijk al inhoud van een klant die geen betrekking heeft op de viewer. De viewer neemt doorgaans slechts een deel van het onroerend goed van een webpagina in beslag.

De meest gebruikte gevallen zijn webpagina's die zijn georiënteerd op desktops of tablets en responsieve, ontworpen pagina's die de lay-out automatisch aanpassen, afhankelijk van het apparaattype.

De insluiting met een vaste grootte wordt gebruikt wanneer de viewer de grootte niet wijzigt na de eerste keer laden. Deze methode is de beste keuze voor webpagina's met een statische indeling.

Bij het insluiten van responsieve ontwerpen wordt ervan uitgegaan dat de viewer bij uitvoering de grootte moet wijzigen als reactie op de wijziging van de grootte van de container DIV . De meest gebruikte optie is het toevoegen van een viewer aan een webpagina die een flexibele pagina-indeling gebruikt.

In de responsieve ontwerpinsluitingsmodus werkt de viewer anders, afhankelijk van de manier waarop de container van de webpagina wordt verkleind DIV . Als op de webpagina alleen de breedte van de container DIV wordt ingesteld en de hoogte onbeperkt blijft, kiest de viewer automatisch de hoogte op basis van de hoogte-breedteverhouding van het gebruikte element. Deze functionaliteit zorgt ervoor dat het element perfect in de weergave past zonder opvulling aan de zijkanten. Dit is het meest gangbare geval voor webpagina's die responsieve webontwerplay-outframeworks zoals Bootstrap en Foundation gebruiken.

Als de webpagina zowel de breedte als de hoogte voor de container van de viewer DIV instelt, vult de viewer alleen dat gebied. De pagina volgt ook de grootte die de webpaginalay-out biedt. Een goed voorbeeld is het insluiten van de viewer in een modale overlay, waarbij de grootte van de overlay wordt aangepast aan de venstergrootte van de webbrowser.

Vaste grootte het inbedden

U voegt de viewer als volgt toe aan een webpagina:

  1. Het JavaScript-bestand van de viewer toevoegen aan uw webpagina.

  2. De container definiëren DIV .

  3. De viewergrootte instellen.

  4. De viewer maken en initialiseren

  5. Het JavaScript-bestand van de viewer toevoegen aan uw webpagina.

    Voor het maken van een viewer moet u een scripttag toevoegen aan de kop van HTML. Zorg ervoor dat u CarouselViewer.js opneemt voordat u de viewer-API kunt gebruiken. Het bestand CarouselViewer.js bevindt zich in de submap html5/js/ van uw standaard IS-Viewers-implementatie:

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

U kunt een relatief pad gebruiken als de viewer wordt geïmplementeerd op een van de Adobe Dynamic Media Classic-servers en vanuit hetzelfde domein wordt aangeboden. Anders geeft u een volledig pad op naar een van de Adobe Dynamic Media Classic-servers waarop IS-Viewers zijn geïnstalleerd.

Het relatieve pad ziet er als volgt uit:

<script language="javascript" type="text/javascript" src="/etc/dam/viewers/s7viewers/html5/js/CarouselViewer.js"></script>
NOTE
Verwijs alleen naar het JavaScript include -hoofdviewerbestand op uw pagina. Verwijs geen extra JavaScript-bestanden in de webpaginacode die door de logica van de viewer tijdens de uitvoering kunnen worden gedownload. Verwijs met name niet rechtstreeks naar de HTML5 SDK Utils.js -bibliotheek die door de viewer is geladen vanuit het /s7viewers contextpad (de zogenaamde geconsolideerde SDK include ). De reden hiervoor is dat de locatie van Utils.js of vergelijkbare runtimeviewerbibliotheken volledig wordt beheerd door de logica van de viewer en dat de locatie verandert tussen de viewerreleases. Adobe houdt oudere versies van de secundaire viewer includes niet op de server.
Als u dus een directe verwijzing naar een secundaire JavaScript include op de pagina plaatst, wordt de viewerfunctionaliteit in de toekomst verbroken wanneer een nieuwe productversie wordt geïmplementeerd.
  1. De container definiëren DIV .

    Voeg een leeg DIV -element toe aan de pagina waarop u de viewer wilt weergeven. De id van het element DIV moet zijn gedefinieerd omdat deze id later wordt doorgegeven aan de viewer-API. De grootte van het DIV-bestand wordt bepaald door CSS.

    De plaatsaanduiding DIV is een gepositioneerd element, wat betekent dat de eigenschap position CSS is ingesteld op relative of absolute .

    Hieronder ziet u een voorbeeld van een gedefinieerd plaatsaanduidingselement DIV :

    code language-css
    <div id="s7viewer" style="position:relative"></div>
    
  2. De viewergrootte instellen

    U kunt de statische grootte voor de viewer instellen door de viewer te declareren voor de CSS-klasse op hoofdniveau in absolute eenheden of door de optie .s7carouselviewer te gebruiken.stagesize

    U kunt de grootte in CSS rechtstreeks op de HTML-pagina plaatsen. U kunt de grootte ook in een aangepast CSS-bestand van de viewer plaatsen, dat later wordt toegewezen aan een record met viewervoorinstellingen in AEM Assets - Op aanvraag of expliciet wordt doorgegeven met de opdracht style .

    Zie het Aanpassen van de Kijker van Carouselvoor meer informatie over het stileren van de kijker met CSS.

    Hieronder ziet u een voorbeeld van het definiëren van een statische viewergrootte op de HTML-pagina:

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

    U kunt de optie stagesize expliciet doorgeven met de initialisatiecode van de viewer met params -verzameling of als een API-aanroep, zoals wordt beschreven in de sectie Opdrachtverwijzing:

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

    Een op CSS gebaseerde benadering wordt geadviseerd en in dit voorbeeld gebruikt.

  3. De viewer maken en initialiseren

    Wanneer u de bovenstaande stappen hebt uitgevoerd, maakt u een instantie van de klasse s7viewers.CarouselViewer , geeft u alle configuratiegegevens door aan de constructor en roept u de methode init() aan voor een viewerinstantie. De informatie van de configuratie wordt overgegaan tot de aannemer als voorwerp JSON. Dit object moet minimaal een containerId -veld hebben met de naam van de viewercontainer-id en een genest params JSON-object met configuratieparameters die door de viewer worden ondersteund. In dit geval moet voor het params -object ten minste de URL van de afbeeldingsserver worden doorgegeven als eigenschap serverUrl en het eerste element als parameter asset . Met de op JSON gebaseerde initialisatie-API kunt u de viewer maken en starten met één coderegel.

    Het is belangrijk dat de viewercontainer aan het DOM wordt toegevoegd, zodat de viewercode het containerelement op basis van de id kan vinden. Sommige browsers stellen het samenstellen van DOM tot het einde van de webpagina uit. Roep voor maximale compatibiliteit de methode init() aan vlak voor de afsluitende BODY -tag of voor de body onload() -gebeurtenis.

    Tegelijkertijd mag het containerelement nog niet noodzakelijkerwijs deel uitmaken van de webpaginalay-out. Het kan bijvoorbeeld verborgen zijn met de daaraan toegewezen display:none stijl. In dit geval vertraagt de viewer het initialisatieproces totdat de webpagina het containerelement weer in de layout plaatst. Wanneer deze functionaliteit optreedt, wordt het laden van de viewer automatisch hervat.

    Hieronder ziet u een voorbeeld van het maken van een viewer-instantie, het doorgeven van de minimaal benodigde configuratieopties aan de constructor en het aanroepen van de methode init() . In het voorbeeld wordt ervan uitgegaan dat carouselViewer de viewerinstantie is; s7viewer is de naam van de plaatsaanduiding DIV; https://adobedemo62-h.assetsadobe.com/is/image is de URL van de afbeeldingsserver en /content/dam/dm-public-facing-live-demo-page/04_shoppable_carousel/05_shoppable_banner is het element:

    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>
    

    De volgende code is een volledig voorbeeld van een triviale webpagina die de Carousel Viewer insluit met een vaste grootte:

    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>
    

Responsief ontwerp inbeddend met onbeperkte hoogte

Bij responsieve ontwerpinsluiting heeft de webpagina normaal gesproken een flexibele indeling die de runtimegrootte van de container van de viewer DIV bepaalt. In het volgende voorbeeld wordt ervan uitgegaan dat de webpagina de container van de viewer DIV 40% van de venstergrootte van de webbrowser laat innemen. En de hoogte blijft onbeperkt. De HTML-code van de webpagina ziet er als volgt uit:

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

Het toevoegen van de viewer aan een dergelijke pagina is vergelijkbaar met de stappen voor het insluiten van een vaste grootte. Het enige verschil is dat u de viewergrootte niet expliciet hoeft te definiëren.

  1. Het JavaScript-bestand van de viewer toevoegen aan uw webpagina.
  2. De container definiëren DIV .
  3. De viewer maken en initialiseren

Alle bovenstaande stappen zijn gelijk aan die bij het insluiten van de vaste grootte. Voeg de container DIV toe aan de bestaande "holder" DIV . De volgende code is een volledig voorbeeld. U ziet hoe de grootte van de viewer verandert wanneer de browser wordt aangepast en hoe de hoogte-breedteverhouding van de viewer overeenkomt met het element.

<!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>

De volgende voorbeeldpagina illustreert het levensechte gebruik van responsieve ontwerpinsluiting met onbeperkte hoogte:

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

Flexibele grootte die met Gedefinieerde Breedte en Hoogte inbedt

In insluiten van flexibele grootte waarbij breedte en hoogte zijn gedefinieerd, is de opmaak van de webpagina anders. Het biedt beide grootten voor de "holder" DIV en centreert deze in het browservenster. Bovendien stelt de webpagina de grootte van het element HTML en BODY in op 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>

De overige insluitingsstappen zijn identiek aan de stappen die worden gebruikt voor het insluiten van responsieve lagen met onbeperkte hoogte. Het resulterende voorbeeld is het volgende:

<!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>

Inbeddend het Gebruiken van op zetter-Gebaseerde API

In plaats van JSON-gebaseerde initialisatie, is het mogelijk om op setter-gebaseerde API en no-args aannemer te gebruiken. Wanneer u deze API-constructor gebruikt, worden er geen parameters gebruikt en worden configuratieparameters opgegeven met de API-methoden setContainerId() , setParam() en setAsset() met afzonderlijke JavaScript-aanroepen.

In het volgende voorbeeld wordt het gebruik van insluiting met een vaste grootte met de op een setter gebaseerde API geïllustreerd:

<!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