Carousel-komponent carousel-component
Med Core Component Carousel Component kan innehållsförfattaren presentera innehållet i en navigerbar karusell.
Användning usage
Med hjälp av Carousel Component kan innehållsförfattaren ordna innehållet i en roterande karusell med bilder.
I dialogrutan Redigera kan innehållsförfattaren skapa, namnge och ordna flera bilder samt aktivera automatisk övergång med fördröjning. Med hjälp av designdialogrutan kan mallskaparen definiera vilka komponenter som kan läggas till i karusellen, aktivera eller inaktivera automatiska övergångar och anpassa formaten.
Version och kompatibilitet version-and-compatibility
Den aktuella versionen av Carousel Component är v1, som introducerades i version 2.2.0 av Core Components i oktober 2018, och som beskrivs i det här dokumentet.
Följande tabell visar alla versioner av komponenten som stöds, de AEM versionerna som komponenterna är kompatibla med och länkar till dokumentation för tidigare versioner.
Mer information om versioner och versioner av kärnkomponenter finns i dokumentet Core Components Versions.
Exempel på komponentutdata sample-component-output
Om du vill visa Carousel-komponenten och se exempel på dess konfigurationsalternativ samt HTML och JSON-utdata går du till komponentbiblioteket.
Teknisk information technical-details
Den senaste tekniska dokumentationen om Carousel-komponenten finns på GitHub.
Mer information om hur du utvecklar kärnkomponenter finns i dokumentationen för kärnkomponentutvecklare.
Djuplänkning till en panel deep-linking
Carousel, Tabbar, och dragspelskomponenter har stöd för att länka direkt till en panel i komponenten.
Så här gör du:
- Visa sidan med komponenten med alternativet Visa som publicerad i sidredigeraren.
- Inspect innehållet på sidan och identifierar panelens ID.
- Till exempel
id="carousel-bfe4fa6647-item-47f1a7ca67-tabpanel"
- Till exempel
- ID:t blir det ankare som du kan lägga till i URL:en med hjälp av ett hash-tecken (
#).- Till exempel
https://wknd.site/content/wknd/language-masters/en/magazine/western-australia.html#carousel-bfe4fa6647-item-47f1a7ca67-tabpanel
- Till exempel
Om du navigerar till URL-adressen med panel-ID som ankarpunkt, rullar webbläsaren direkt till den aktuella komponenten och visar den angivna panelen. Om panelen inte är konfigurerad att visas som standard rullas den automatiskt.
Carousel och responsiv design responsive-design
Alla kärnkomponenter är utformade för att vara fullt responsiva och ger en sömlös upplevelse på alla enheter.
Vissa avancerade komponenter som Carousel Component kan kräva särskild hänsyn i samband med implementeringsprojektet för att kunna behålla sin lyhördhet under alla förhållanden. Mer information finns i dokumentet Responsiv design för kärnkomponenterna.
Dialogrutan Redigera edit-dialog
I redigeringsdialogrutan kan innehållsförfattaren lägga till, byta namn på och ordna om bilder samt definiera inställningarna för automatisk övergång.
Fliken Objekt items-tab
Använd knappen Lägg till för att öppna komponentväljaren och välja vilken komponent som ska läggas till som en flik. När du har lagt till en post läggs den till i listan, som innehåller följande kolumner:
- Ikon - Ikonen för flikens komponenttyp, vilket gör det enkelt att identifiera i listan. För musen över för att se det fullständiga komponentnamnet som ett verktygstips.
- Beskrivning - Den beskrivning som används som tabbtext och som standard används som namn på den komponent som har valts för fliken.
- Ta bort - Tryck eller klicka för att ta bort fliken från flikkomponenten.
- Ändra ordning - Tryck eller klicka och dra för att ordna flikarna.
Fliken Egenskaper properties-tab
På fliken Egenskaper kan innehållsförfattaren ange att bildrutorna ska övergå automatiskt.
-
Aktivt objekt - Innehållsförfattaren kan definiera vilken flik som är aktiv när sidan läses in.
-
Överför bilder automatiskt - När komponenten är aktiv flyttas den automatiskt till nästa bild efter en angiven fördröjning.
-
Övergångsfördröjning - När automatiskt överför bildrutor är markerat används det här värdet för att definiera fördröjningen mellan övergångar (i millisekunder).
-
Inaktivera automatisk paus vid hovring - När Överför bilder automatiskt är markerat pausas karusellövergången automatiskt när pekaren förs över karusellen. Välj det här alternativet så att övergången inte pausas.
-
ID - Med det här alternativet kan du styra den unika identifieraren för komponenten i HTML och i datalagret.
- Om inget anges genereras ett unikt ID automatiskt åt dig och du hittar det genom att granska den resulterande sidan.
- Om ett ID anges är det författarens ansvar att se till att det är unikt.
- Om du ändrar ID:t kan det påverka spårningen av CSS, JS och datalager.
Fliken Tillgänglighet accessibility-tab
På fliken Hjälpmedel kan värden anges för ARIA-hjälpmedelsetiketter för komponenten.
- Etikett - Värdet på ett aria-label-attribut för karusellen, som beskriver karusellens innehåll
- Föregående - Värdet på ett aria-label-attribut för Carousel-navigeringens föregående knappetikett
- Nästa - Värdet för ett aria-label-attribut för Carousel-navigeringens nästa knappetikett
- Spela upp - Värdet på ett aria-label-attribut för Carousel-navigeringens uppspelningsknappsetikett
- Paus - Värdet för ett arienetikettattribut för karusellnavigeringens pause-knappetikett
- Tablist - Värdet för ett aria-label-attribut för Carousel-navigeringens lista över objekt-etikett
- Ange objektets ariaetikett till dess titel - Om det här alternativet är markerat ställs carousel-objektets titel automatiskt in på dess ariaetikettbeskrivning.
Välj panel select-panel
Innehållsförfattaren kan använda alternativet Välj panel i komponentverktygsfältet för att ändra till en annan bildruta för redigering och även för att enkelt ordna om bildrutorna.
När du har valt alternativet Välj panel i komponentverktygsfältet visas de konfigurerade bildrutorna som en listruta.
- Listan ordnas efter bildrutornas tilldelade placering och återspeglas i numreringen.
- Bildrutans komponenttyp visas först, följt av bildbeskrivningen med ett ljusare teckensnitt.
- Om du trycker eller klickar på en post i listrutan växlar vyn i redigeraren till den bildrutan.
- Du kan ordna om bilden på plats med hjälp av draghandtagen.
Designdialogruta design-dialog
I designdialogrutan kan mallskaparen definiera vilka komponenter som kan läggas till som bilder i karusellkomponenten samt definiera standardvärden för automatisk övergång och vilka anpassade format som är tillgängliga för innehållsförfattaren.
Fliken Egenskaper properties-tab-1
Fliken Egenskaper används för att definiera standardinställningarna för bildövergångarna när en innehållsförfattare lägger till karusellkomponenten på en sida.
- Överför bilder automatiskt - Anger om alternativet att automatiskt flytta karusellen till nästa bild är aktiverat som standard när innehållsförfattaren lägger till karusellkomponenten på en sida.
- Lägg till kontrollelement - När det här alternativet är markerat placeras kontrollelementen framför karusellobjekten för att förbättra tillgängligheten.
Fliken Tillåtna komponenter allowed-components-tab
Fliken Tillåtna komponenter används för att definiera vilka komponenter som innehållsförfattaren kan lägga till som bildrutor i Carousel-komponenten.
Fliken Tillåtna komponenter fungerar på samma sätt som fliken med samma namn när du definierar principen och egenskaperna för en layoutbehållare i mallredigeraren.
Fliken Format styles-tab
Carousel-komponenten stöder AEM Style System.
Adobe-klientdatalager data-layer
Carousel-komponenten stöder Adobe-klientdatalagret.