Utveckla kärnkomponenter

När ska kärnkomponenterna användas?

Eftersom kärnkomponenterna är helt nya och har många fördelar rekommenderar vi att du använder dem i nya AEM. För befintliga projekt bör en migrering ingå i en större projektinsats, till exempel en omprofilering eller en övergripande omfaktorisering.

Adobe ger därför följande rekommendationer:

  • Nya projekt
    Nya projekt bör alltid försöka använda kärnkomponenter. Om kärnkomponenter inte kan användas direkt eller extended för att uppfylla projektkraven skapar du en anpassad komponent enligt komponentarkitekturen som anges i kärnkomponenterna. Undvik att använda grundkomponenter.
  • Befintliga projekt
    Rekommendationen fortsätter att använda grundkomponenter, såvida inte en omfaktorisering av plats eller komponent planeras.
    Eftersom de används i mycket stor utsträckning av de flesta befintliga projekt, är de grundläggande komponenterna fortsätter att stödjas.
  • Nya anpassade komponenter
    Utvärdera om en befintlig Kärnkomponenten kan anpassas.
    I annat fall rekommenderar vi att du skapar en ny anpassad komponent som följer Riktlinjer för komponenter.
  • Befintliga anpassade komponenter
    Om komponenterna fungerar som de ska bör du behålla dem som de är.

    Om inte, se"Nya anpassade komponenter" ovan.

Så här lyckas du med kärnkomponenterna

Core Components är kraftfulla, flexibla och enkla att använda och anpassa. Följ några viktiga riktlinjer säkerställer att ditt projekt med Core Components blir en framgång.

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

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 denna migration har Adobe tillhandahållit ett antal migreringsverktyg för att uppmuntra till användning av kärnkomponenterna och den senaste AEM tekniken.

AEM moderniseringsverktyg möjliggöra enkel konvertering av

  • 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 användningen av dessa verktyg finns i se deras dokumentation.

OBSERVERA

De AEM verktygen är en del av communityn och stöds inte eller motiveras inte av Adobe.

Migrering via Flytta till AEM as a Cloud Service

Eftersom AEM as a Cloud Service automatiskt har den senaste versionen av Core Components måste du ta bort allt beroende av Core Components i dina projekt när du går från en lokal AEM installation. pom.xml -fil.

Proxykomponenterna kommer fortfarande att fungera som de gjorde tidigare eftersom utkast pekar på den nödvändiga supertypen och supertypssökvägen 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 till 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>

Se dokumentet AEM projektstruktur för mer information om AEMaaCS-projekt.

Stöd för kärnkomponenter

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

Liksom andra AEM produktfunktioner är den allmänna regeln: Komponenter tillkännages först som borttagna och den tidigaste borttagningen för nästa AEM. 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 som stöds. När stödet upphör för en version av AEM gör det även stödet för kärnkomponenterna för den versionen av AEM.

Mer information om stöd för komponentanpassningar finns i Anpassa kärnkomponenter sida.

Teknisk kapacitet

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 i gå till redigeringssidan om dem.

Funktion Kärnkomponent Foundation Component
Logikimplementering Java POJOs with Sling Models anteckningar JSP-kod
Markeringsdefinition HTML mallspråk (HTML) syntax JSP-kod
XSS-sanering Automatiserad av HTML Mest manuella
Namnge CSS-klasser Standardiserad namnkonvention baserad på Blockelementsmodifierare (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
Versionshantering 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-standard Endast delvis kompatibelt med WCAG 2.0 AA-standard

Komponentlista

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
Dolt formulär 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 -
Experience Fragment 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

En fördel med versionskomponenter är att det går att separera migreringen till en ny AEM 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 kommer inte att påverka hur kärnkomponenterna fungerar, förutsatt att deras versioner också har stöd för den nya AEM som migreras till. Anpassningar som görs i kärnkomponenterna bör inte heller påverkas, så länge de inte använder API:er som har borttagen eller ersatt.

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 i Anpassa kärnkomponenter sida.

På denna sida