Utveckla kärnkomponenter developing-core-components

Med Core Components får du robusta och utbyggbara baskomponenter med funktionsrika funktioner, kontinuerlig leverans, versionshantering av komponenter, modern implementering, tunn markering och JSON-export av innehåll.

TIP
Har du övervägt Edge Delivery Services för AEM?
Du kan fortsätta använda metoderna som beskrivs i det här dokumentet för befintliga projekt. För nya projekt rekommenderar Adobe att du drar nytta av Edge Delivery Services.

Så här lyckas du med kärnkomponenterna how-to-succeed

Core Components är kraftfulla, flexibla och enkla att använda och anpassa. Om du följer några viktiga riktlinjer ser du till att ditt projekt med kärnkomponenterna fungerar som det ska.

Migrera till kärnkomponenterna

Alla nya projekt ska implementeras med kärnkomponenter. Befintliga projekt har dock oftast omfattande implementeringar av Foundation Components.

Migrerar från Foundation Components from-foundation

En större insats i ett befintligt projekt (till exempel en omprofilering eller en övergripande omfaktorisering) ger ofta möjlighet att migrera till kärnkomponenterna. För att underlätta migreringen har Adobe tillhandahållit ett antal migreringsverktyg för att uppmuntra användningen av kärnkomponenterna och den senaste AEM-tekniken.

Med AEM moderniseringsverktyg kan du enkelt konvertera:

  • Statiska mallar till redigerbara mallar
  • Designkonfigurationer till policyer
  • Foundation-komponenter till Core-komponenter
  • Klassiskt användargränssnitt till pekaktiverat användargränssnitt

Mer information om hur dessa verktyg används finns i dokumentationen för dem.

NOTE
AEM Modernize Tools är en community-åtgärd som inte stöds eller garanteras av Adobe.

Migrering via Move to AEM as a Cloud Service via-aemaacs

Eftersom AEM as a Cloud Service har den senaste versionen av Core Components automatiskt måste du ta bort alla beroenden till Core Components i din pom.xml-projektfil när du flyttar från en lokal AEM-installation.

Proxykomponenterna fungerar fortfarande som de gjorde tidigare eftersom utkast pekar på den nödvändiga supertypen och den överordnade textbanan har versionen i den. På så sätt kan du bara ta bort beroendet och få Core Components att fungera i AEMaaCS på samma sätt som lokalt.

Precis som andra AEMaaCS-projekt måste du också lägga in ett beroende i AEM SDK jar. Detta är inte specifikt för kärnkomponenterna, men krävs.

<dependency>
   <groupId>com.adobe.aem</groupId>
   <artifactId>aem-sdk-api</artifactId>
</dependency>

Mer information om AEMaaCS-projekt finns i dokumentet AEM Project Structure.

Stöd för kärnkomponenter core-component-support

Core Components är en integrerad del av AEM och stöds som det är, på samma villkor som om de levererades som en del av QuickStart.

Precis som för andra AEM-produktfunktioner är den allmänna regeln: Komponenter tillkännages först som inaktuella och den tidigaste borttagningen för följande AEM-version. Det ger kunderna minst en releasecykel att gå över till den nya versionen av komponenten innan stödet släpps.

Versionen för varje komponent anger tydligt vilka AEM-versioner som stöds. När supporten för en version av AEM upphör, gör det också stödet för Core Components för den versionen av AEM.

Mer information om stöd för komponentanpassningar finns på sidan Anpassa kärnkomponenter.

Teknisk kapacitet technical-capabilities

Följande tabell ger en översikt över skillnaderna mellan kärnkomponenter och grundkomponenter.

Mer information om deras redigeringsfunktioner och alternativ för att förkonfigurera dem finns på redigeringssidan om dem.

Funktion
Kärnkomponent
Foundation Component
Logic implementation
Java-POJO med delningsmodeller anteckningar
JSP-kod
Markeringsdefinition
Syntax för HTML-mallspråk (HTML)
JSP-kod
XSS-sanering
Automatiserad av HTML
Mest manuella
Namnge CSS-klasser
Standardiserad namnkonvention baserad på Blockelementets modifierare (BEM)-notation (från och med version 2.0.0)
Anpassade scheman
Dialogdefinition
Korall 3
Coral 2 + Classic UI
JSON-utdata
Sling Models Exporter med Jackson-serialisering
Default Sling-server
Versioner
För modellen och HTML
Ingen
Testning
Enhetstester + integrationstester
Integrationstester
Leverans
Via offentlig GitHub
Via QuickStart
Licens
Apache-licens
Adobe
Bidrag
Via pull-begäran
Inte möjligt
Tillgänglighet
Fullt kompatibel med WCAG 2.0 AA-standarden
Endast delvis kompatibel med WCAG 2.0 AA-standarden

Komponentlista component-list

I följande tabell visas de tillgängliga kärnkomponenterna, som länkar till deras API, och vilka grundläggande komponenter de ersätter.

Kärnkomponent
Beskrivning
Ersatt Foundation-komponent(er)
Sida
Responsiv sida som arbetar med mallredigerare
/libs/foundation/components/page /libs/wcm/foundation/components/page
Breadcrumb
Navigering i sidhierarki
/libs/foundation/components/breadcrumb
Titel
H1-H6-titel
/libs/foundation/components/title /libs/wcm/foundation/components/title
Text
RTF
/libs/foundation/components/text /libs/foundation/components/table /libs/wcm/foundation/components/text
Bild
Smart och lat inläsning av optimal återgivningsstorlek
/libs/foundation/components/image /libs/foundation/components/adaptiveimage /libs/foundation/components/logo /libs/foundation/components/mobileimage /libs/foundation/components/mobilelogo /libs/wcm/foundation/components/image
Lista
Lista över sidor
/libs/foundation/components/list /libs/foundation/components/mobilelist /libs/wcm/foundation/components/list
Delning av sociala medier
Delningswidgeten Facebook och Pinterest
-
Formulärbehållare
Styckesystem för responsiva formulär
/libs/foundation/components/form/start /libs/foundation/components/form/end
Formulärtext
Textinmatningsfält
/libs/foundation/components/form/text /libs/foundation/components/form/password
Formuläralternativ
Indatafält för flera alternativ
/libs/foundation/components/form/checkbox /libs/foundation/components/form/radio /libs/foundation/components/form/dropdown
Formuläret dolt
Dolt indatafält
/libs/foundation/components/form/hidden
Formulärknapp
Skicka eller anpassa knapp
/libs/foundation/components/form/submit
Navigering
En webbplatsnavigeringskomponent som listar den kapslade sidhierarkin
/libs/foundation/components/topnav /libs/foundation/components/mobiletopnav
Språknavigering
En språk- och landsväljare som listar den globala språkstrukturen
-
Snabbsökning
En sökkomponent som visar resultaten som förslag på plats i en nedrullningsbar meny
/libs/foundation/components/search
Teaser
Gör det möjligt för innehållsförfattaren att enkelt skapa ett suddgummi för ytterligare innehåll med hjälp av en bild, en titel eller formaterad text och länka till ytterligare innehåll eller andra åtgärder
-
Tabbar
Låter innehållsförfattaren organisera sidinnehåll på flera flikar
-
Carousel
Låter innehållsförfattaren ordna innehållet i en roterande karusell med bilder
/libs/foundation/components/carousel
Innehållsfragment
Tillåter visning av ett innehållsfragment
-
Innehållsfragmentlista
Gör att en lista med innehållsfragment kan visas
-
Avgränsare
Delar upp innehållet på en sida
-
Dragspel
Ordna innehållspaneler i ett komprimerbart dragspel
-
Behållare
Ordna komponenter i en behållare
-
Knapp
Skapa en knapp på en sida
-
Hämta
Lägga till en hämtningsbar resurs på en sida
-
Upplevelsefragment
Lägga till ett upplevelsefragment på en sida
/libs/cq/experience-fragments/editor/components/experiencefragment
Bädda in
Bädda in en extern resurs på en sida
-
Förloppsindikator
Ge en visuell representation av framstegen mot ett mål
-
PDF Viewer
Presenterar ett PDF-dokument på en sida
-

Uppgradering av kärnkomponenter upgrade-of-core-components

En fördel med versionskomponenter är att det går att separera migreringen till en ny AEM-version från migreringen till nya komponentversioner. Om det finns nya komponentversioner är det också möjligt att migrera varje komponent individuellt till den nya versionen.

Migreringar till en ny AEM-version påverkar inte hur Core Components fungerar, förutsatt att deras versioner även stöder den nya AEM-versionen som migreras till. Anpassningar som görs för kärnkomponenterna ska inte heller påverkas, så länge de inte använder API:er som har tagits bort eller tagits bort.

Migreringar till nya versioner av kärnkomponenterna kommer inte heller att påverka hur komponenten fungerar, men nya funktioner kan introduceras för sidförfattare, vilket kan kräva viss konfiguration av en mallredigerare om standardbeteendet inte önskas. Anpassningar kan dock behöva anpassas. Mer information finns på sidan Anpassa kärnkomponenter.

recommendation-more-help
d2be9096-a81e-404b-9952-d8925af7219c