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.
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 frihandsritad HTML som även ska bäddas in.
- Komponentens egenskaper kan definieras i konfigurera dialogruta.
- Standardvärden för komponenten när du lägger till den på en sida kan definieras i designdialogruta.
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 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 Huvudkomponentversioner.
Exempel på komponentutdata sample-component-output
Om du vill se exempel på den inbäddade komponenten och dess konfigurationsalternativ samt HTML och JSON-utdata går du till Komponentbibliotek.
Teknisk information technical-details
Den senaste tekniska dokumentationen om komponenten Embed finns på GitHub.
Mer information om hur du utvecklar kärnkomponenter finns i Dokumentation för grundkomponentutvecklare.
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 en ID. Med det här alternativet kan du styra den unika identifieraren för komponenten i HTML och i Datalager.
- 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 URL fält. Komponenten försöker komma åt resursen och om den kan återges av någon av processorerna visas ett bekräftelsemeddelande under URL fält. Annars markeras fältet med fel.
Den inbäddade komponenten levereras med processorer för följande typer av resurser:
- Resurser som uppfyller Bädda in standard inklusive Facebook Post, Instagram, SoundCloud, Twitter och YouTube
Utvecklare kan lägga till ytterligare URL-processorer av följer utvecklardokumentationen för Embed Component.
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.
The Inbäddad -fältet anger vilken typ av processor som 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 du använder Visa som publicerad i utvecklingsinstansen.
- Aktivera loop - Om det gäller 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 direktuppspelning (iOS) - Den här parametern styr om videoklipp spelas upp textbundet (på) eller i helskärmsläge (av) i en HTML5-spelare på iOS.
- Obegränsade relaterade videoklipp - Om det här alternativet är inaktiverat kommer relaterade videofilmer från samma kanal som den video som just spelades upp, annars kommer de från vilken kanal som helst.
Andra inbäddade tabeller kan erbjuda liknande fält och kan definieras av en utvecklare av följer utvecklardokumentationen för Embed Component.
HTML html
Du kan lägga till frihandskomponenten HTML på sidan med hjälp av komponenten Bädda in.
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 gäller alla skript och style element och alla on* och style attribut tas bort från utdata.
Reglerna är dock mer komplicerade eftersom inbäddningskomponenten följer AEM globala filterregeluppsättningen 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 för lokala installationer och AEM as a Cloud Service installationer.
/libs/cq/xssprotection/config.xmlpåverkar dessa ändringar alla HTML- och JSP-beteenden och inte bara Bädda in kärnkomponent.Fliken Format styles-tab-edit
Komponenten Embed stöder AEM Formatsystem..
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 designdialogruta 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 URL alternativ för innehållsförfattaren när den är vald
- Inaktivera inbäddade tabeller - Inaktiverar Inbäddad när det här alternativet är markerat för innehållsförfattaren, oavsett vilka inbäddade processorer som är tillåtna.
- Inaktivera HTML - Inaktiverar HTML för innehållsförfattaren när detta är markerat.
- Tillåtna inbäddade tabeller - Multiselect som definierar vilka inbäddade processorer som är tillgängliga för innehållsförfattaren, förutsatt att Inbäddad alternativet är aktivt.
YouTube Tab youtube-tab
- Tillåt konfiguration av ljudavstängningsbeteende - Innehållsförfattaren kan konfigurera Aktivera ljud av i komponenten när YouTube-inbäddningstypen är markerad
- Standardvärde för ljud av - Anger automatiskt Aktivera ljud av när YouTube-inbäddningstypen är markerad
- Tillåt konfiguration av automatiskt uppspelningsbeteende - Innehållsförfattaren kan konfigurera Aktivera automatisk uppspelning i komponenten när YouTube-inbäddningstypen är markerad
- Standardvärde för automatisk uppspelning - Anger automatiskt Aktivera automatisk uppspelning när YouTube-inbäddningstypen är markerad
- Tillåt konfiguration av loopbeteende - Innehållsförfattaren kan konfigurera Aktivera loop i komponenten när YouTube-inbäddningstypen är markerad
- Standardvärde för slinga - Anger automatiskt Aktivera loop när YouTube-inbäddningstypen är markerad
- Tillåt konfiguration av intern uppspelning (iOS) - Innehållsförfattaren kan konfigurera Aktivera direktuppspelning (iOS) i komponenten när YouTube-inbäddningstypen är markerad
- Standardvärde för direktuppspelning (iOS) - Anger automatiskt Aktivera direktuppspelning (iOS) när YouTube-inbäddningstypen är markerad
- Tillåt konfiguration av textbundna videoklipp - Innehållsförfattaren kan konfigurera Obegränsade relaterade videoklipp i komponenten när YouTube-inbäddningstypen är markerad
- Standardvärde för obegränsade relaterade videoklipp - Anger automatiskt Obegränsade relaterade videoklipp när YouTube-inbäddningstypen är markerad