Utveckla kärnkomponenter developing-core-components

När ska kärnkomponenterna användas? when-to-use-the-core-components

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 how-to-succeed

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 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 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.

NOTE
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 via-aemaacs

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 core-component-support

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 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 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 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
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 upgrade-of-core-components

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.

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