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 det inte går att använda kärnkomponenter direkt eller extended för att uppfylla projektkraven skapar du en anpassad komponent enligt komponentarkitekturen som anges i kärnkomponenterna. Undvik att använda Foundation-komponenterna om inte annat är möjligt.
  • Befintliga projekt
    Rekommendationen fortsätter att använda Foundation-komponenternaom inte en webbplats- eller komponentomfaktorisering planeras.
    Eftersom de används mycket ofta i de flesta befintliga projekt stöds även grundkomponenterna .
  • Nya anpassade komponenter
    Utvärdera om en befintlig Core-komponent kan anpassas.
    Om det inte gör det bör du skapa en ny anpassad komponent enligt riktlinjerna 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. 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 denna migration har Adobe tillhandahållit ett antal migreringsverktyg för att uppmuntra till användning av kärnkomponenterna och den senaste AEM tekniken.

Med verktygen AEM modernisering 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
De AEM verktygen är en del av communityn och stöds inte eller motiveras inte av Adobe.

Migrering via Move to 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 alla beroenden till Core Components i din pom.xml-projektfil när du flyttar från en lokal AEM.

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

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

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 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
HTML-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 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 även stöder den nya AEM 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