Bädda in komponent embed-component
Med Core Components Embed Component (Bädda in kärnkomponenter) kan du bädda in externt innehåll på en AEM-innehållssida.
Användning usage
Med Core Component Embed Component (Bädda in kärnkomponent) kan innehållsförfattaren definiera markerat externt innehåll som ska bäddas in på en AEM-innehållssida. Dessutom finns det ett alternativ för att definiera frihandsritade HTML som även ska bäddas in.
- Komponentens egenskaper kan definieras i dialogrutan Konfigurera.
- Standardvärden för komponenten när du lägger till den på en sida kan definieras i designdialogrutan.
Version och kompatibilitet version-and-compatibility
Den aktuella versionen av Embed Component är v2, som introducerades i version 2.18.0 av Core Components i februari 2022, och som beskrivs i det här dokumentet.
Följande tabell visar alla versioner av komponenten som stöds, de AEM-versioner som komponenterna är kompatibla med samt 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 den inbäddade komponenten samt exempel på dess konfigurationsalternativ samt HTML- och JSON-utdata går du till komponentbiblioteket.
Teknisk information technical-details
Den senaste tekniska dokumentationen om den inbäddade komponenten finns på GitHub.
Mer information om hur du utvecklar kärnkomponenter finns i dokumentationen för kärnkomponentutvecklare.
Konfigurera dialogruta configure-dialog
I dialogrutan Konfigurera kan innehållsförfattaren definiera den externa resurs som ska bäddas in på sidan.
Fliken Egenskaper properties-tab
Välj först vilken typ av resurs som ska bäddas in:
Du kan definiera ett ID för varje typ av inbäddningsbar. 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.
URL url
Den enklaste inbäddningen är URL-adressen. Klistra bara in URL:en för resursen som du vill bädda in i fältet URL. Komponenten försöker komma åt resursen och om den kan återges av någon av processorerna visas ett bekräftelsemeddelande under fältet URL. Annars markeras fältet med fel.
Den inbäddade komponenten levereras med processorer för följande typer av resurser:
- Resurser som följer standarden Inkludera, inklusive Facebook Post, Instagram, SoundCloud, Twitter och YouTube
Utvecklare kan lägga till ytterligare URL-processorer genom att följa utvecklardokumentationen för den inbäddade komponenten.
Inbäddad embeddable
Inbäddade tabeller gör det möjligt att anpassa den inbäddade resursen mer, som kan parametriseras och innehålla ytterligare information. En författare kan välja bland förkonfigurerade tillförlitliga inbäddade filer och komponenten levereras med en YouTube-inbäddad som är färdig att användas.
Fältet Inbäddbar definierar vilken typ av processor du vill använda. När det gäller den inbäddade YouTube-funktionen kan du definiera:
- Video-ID - Det unika video-ID:t från YouTube för resursen som du vill bädda in
- Bredd - Bredden på den inbäddade videon
- Höjd - Höjden på den inbäddade videon
- Aktivera ljud av - Den här parametern anger om videon spelas upp som standard. Om du aktiverar det här alternativet ökar risken för att Autoplay fungerar i moderna webbläsare.
- Aktivera automatisk uppspelning - Den här parametern anger om den inledande videon automatiskt ska börja spelas upp när spelaren läses in. Detta gäller endast för publiceringsinstansen eller när alternativet Visa som publicerad används i redigeringsinstansen.
- Aktivera slinga - Om det är en enda video anger den här parametern om spelaren ska spela upp den inledande videon upprepade gånger. När det gäller en spellista spelar spelaren upp hela spellistan och startar sedan igen vid den första videon.
- Aktivera textbunden uppspelning (iOS) - Den här parametern kontrollerar om videoklipp spelas upp textbundet (på) eller helskärm (av) i en HTML5-spelare på iOS.
- Obegränsade relaterade videoklipp - Om det här alternativet är inaktiverat kommer relaterade videoklipp från samma kanal som videon som spelades upp, annars kommer de från vilken kanal som helst.
Andra inbäddade tabeller kan innehålla liknande fält och kan definieras av en utvecklare av efter utvecklardokumentationen för den inbäddade komponenten.
HTML html
Du kan lägga till frihandskomponenten HTML på sidan med hjälp av inbäddningskomponenten.
Dokumentskydd security
Den HTML-kod som författaren kan ange filtreras av säkerhetsskäl för att undvika serveröverskridande skriptattacker (cross-site scripting) som till exempel skulle kunna ge författare administratörsbehörighet.
I allmänhet tas alla skript och style-element samt alla on* - och style -attribut bort från utdata.
Reglerna är dock mer komplicerade eftersom Bädda in komponent följer AEM globala filterregeluppsättning för HTML AntiSamy-sanitets, som finns på /libs/cq/xssprotection/config.xml. Detta kan vid behov överlappas av en utvecklare för projektspecifik konfiguration.
Ytterligare säkerhetsinformation finns i AEM utvecklardokumentation för lokala installationer samt AEM as a Cloud Service-installationer.
/libs/cq/xssprotection/config.xml åsidosätts, påverkar de alla HTML- och JSP-beteenden och inte bara Bädda in kärnkomponent.Fliken Format styles-tab-edit
Den inbäddade komponenten stöder AEM Style System..
Använd listrutan för att välja de format som du vill använda på komponenten. Markeringar som görs i redigeringsdialogrutan har samma effekt som de som väljs i komponentverktygsfältet.
Format måste konfigureras för den här komponenten i designdialogrutan för att den nedrullningsbara menyn ska vara tillgänglig.
Designdialogruta design-dialog
I designdialogrutan kan mallskaparen definiera de alternativ som är tillgängliga för den som använder den inbäddade komponenten och de standardvärden som anges när den monterar den inbäddade komponenten.
Fliken Inbäddade typer embeddable-types-tab
- Inaktivera URL - Inaktiverar alternativet URL för innehållsförfattaren när det är markerat
- Inaktivera inbäddade tabeller - Inaktiverar alternativet Inbäddbar för innehållsförfattaren när det är markerat, oavsett vilka inbäddade processorer som är tillåtna.
- Inaktivera HTML - Inaktiverar alternativet HTML för innehållsförfattaren när det är markerat.
- Tillåtna inbäddade tabeller - Multimarkering som definierar vilka inbäddade processorer som är tillgängliga för innehållsförfattaren, förutsatt att alternativet Inbäddbar är aktivt.
YouTube Tab youtube-tab
- Tillåt konfiguration av ljudavstängningsbeteende - Innehållsförfattaren kan konfigurera alternativet Aktivera ljud i komponenten när YouTube-inbäddningstypen är vald
- Standardvärdet för ljud av - Anger automatiskt alternativet Aktivera ljud av när YouTube-inbäddningstypen har valts
- Tillåt konfiguration av automatiskt uppspelningsbeteende - Innehållsförfattaren kan konfigurera alternativet Aktivera automatisk uppspelning i komponenten när YouTube-inbäddningstypen har valts
- Standardvärdet för automatisk uppspelning - Anger automatiskt alternativet Aktivera automatisk uppspelning när YouTube-inbäddningstypen har valts
- Tillåt konfiguration av loopbeteende - Innehållsförfattaren kan konfigurera alternativet Aktivera loop i komponenten när YouTube-inbäddningstypen har valts
- Standardvärde för slinga - Anger automatiskt alternativet Aktivera slinga när YouTube-inbäddningstypen har valts
- Tillåt konfiguration av intern uppspelning (iOS) - Innehållsförfattaren kan konfigurera alternativet Aktivera intern uppspelning (iOS) i komponenten när YouTube-inbäddningstypen har valts
- Standardvärde för intern uppspelning (iOS) - Anger automatiskt alternativet Aktivera intern uppspelning (iOS) när YouTube-inbäddningstypen är vald
- Tillåt konfiguration av textbundna videoklipp - Innehållsförfattaren kan konfigurera alternativet Obegränsade relaterade videoklipp i komponenten när YouTube-inbäddningstypen har valts
- Standardvärde för obegränsade relaterade videoklipp - Anger automatiskt alternativet Obegränsade relaterade videoklipp när YouTube-inbäddningstypen har valts