Basiscomponenten ontwikkelen developing-core-components

Wanneer moet u de kerncomponenten gebruiken? when-to-use-the-core-components

Aangezien de Componenten van de Kern allen-nieuw zijn, en veelvoudige voordelen aanbieden, wordt het geadviseerd voor nieuwe AEM projecten om hen te gebruiken. Voor bestaande projecten zou een migratie deel moeten uitmaken van een grotere projectinspanning, bijvoorbeeld een herbranding of het totale refactoring.

Daarom doet de Adobe de volgende aanbevelingen:

  • Nieuwe Projecten
    De nieuwe projecten zouden altijd moeten proberen om de Componenten van de Kern te gebruiken. Als de Componenten van de Kern niet direct kunnen worden gebruikt of uitgebreidom aan projectvereisten te voldoen, dan creeer een douanecomponent na de componentenarchitectuur die in kerncomponenten wordt vermeld. Behalve waar anders niet mogelijk, vermijd het gebruiken van de stichtingscomponenten.
  • Bestaande Projecten
    De aanbeveling houdt gebruikend de stichtingscomponenten, tenzij een plaats of componentenrefactoring wordt gepland.
    Aangezien zij zeer wijd door de meeste bestaande projecten worden gebruikt, zullen de stichtingscomponenten blijven worden gesteund.
  • Nieuwe Componenten van de Douane
    Beoordeel als een bestaande Component van de Kernkan worden aangepast.
    Als niet, aanbeveling een nieuwe douanecomponent na de Richtlijnen van de Componentmoet bouwen.
  • Bestaande Componenten van de Douane
    Als uw componenten zoals verwacht werken, dan houd hen zoals zij zijn.
    Als dat niet het geval is, raadpleegt u "Nieuwe aangepaste componenten" hierboven.

Hoe te met de Componenten van de Kern Succes how-to-succeed

De kerncomponenten zijn krachtig, flexibel en gebruiksvriendelijk. na een paar zeer belangrijke richtlijnenzal ervoor zorgen dat uw project met de Componenten van de Kern een succes is.

Migreren naar de kerncomponenten

Elk nieuw project moet worden geïmplementeerd met Core Components. Nochtans zullen de bestaande projecten gewoonlijk uitgebreide implementaties van de Componenten van de Stichting hebben.

Migreren van stichtingscomponenten from-foundation

Een grotere inspanning op een bestaand project (bijvoorbeeld rebranding of het algemene refactoring) biedt vaak een kans om aan de Componenten van de Kern te migreren. Om deze migratie te vergemakkelijken, heeft Adobe een aantal migratiehulpmiddelen verstrekt om de goedkeuring van de Core Components en de recentste AEM technologie aan te moedigen.

de Hulpmiddelen van de Modernisering van de AEMstaan voor de gemakkelijke omzetting van toe:

  • Statische sjablonen converteren naar bewerkbare sjablonen
  • Ontwerpconfiguraties omzetten naar beleid
  • Elementaire componenten omzetten naar kerncomponenten
  • De klassieke interface converteren naar een interface met aanraakbediening

Voor verdere informatie over het gebruik van deze hulpmiddelen, zie hun documentatie.

NOTE
De AEM Moderniseringshulpmiddelen zijn een communautaire inspanning en niet gesteund of door Adobe gewaarborgd.

Migratie via Verplaatsen naar AEM as a Cloud Service via-aemaacs

Omdat AEM as a Cloud Service automatisch de nieuwste versie van de Core Components ontvangt, moet u elke afhankelijkheid van de Core Components in uw project pom.xml -bestand verwijderen wanneer u van een installatie op locatie AEM de toepassing overschakelt.

Uw proxycomponenten werken nog steeds zoals voorheen, omdat proxy's verwijzen naar het vereiste supertype en het supertekstpad heeft de versie erin. Op deze manier, eenvoudig het verwijderen van de gebiedsdelen laat de Componenten van de Kern toe om in AEMaaCS te werken enkel zoals zij op-gebouw deden.

Net als bij elk ander AEMaaCS-project moet u ook een afhankelijkheid toevoegen aan de AEM SDK-jar. Dit is niet specifiek voor de Core Components, maar is vereist.

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

Zie het document AEM de Structuur van het Projectvoor meer informatie over projecten AEMaaCS.

Ondersteuning van kerncomponenten core-component-support

De Componenten van de kern zijn een integraal deel van AEM en gesteund zoals is, onder de zelfde voorwaarden alsof zij als deel van Quickstart werden geleverd.

Net als andere AEM productfuncties is de algemene regel: Componenten worden eerst aangekondigd te worden vervangen en de oudste verwijderd voor de volgende AEM. Dit geeft klanten minstens één versiecyclus om naar de nieuwe versie van de component te bewegen, alvorens zijn steun te laten vallen.

In de versie van elke component worden duidelijk de AEM versies vermeld die worden ondersteund. Wanneer de steun voor een versie van AEM beëindigt, dan ook de steun van de Componenten van de Kern voor die versie van AEM.

Voor details over de steun van componentenaanpassingen, zie de Aanpassende pagina van de Componenten van de Kern.

Technische mogelijkheden technical-capabilities

De volgende lijst geeft een overzicht van de verschillen tussen kerncomponenten en stichtingscomponenten.

Voor details over hun auteursmogelijkheden en opties om hen pre-configureerbaar te maken, verwijzen naar de auteurspagina over hen.

Capability
Component van de Kern
Component van de Stichting
Logische implementatie
Java POJOs met Sling Modelsaantekeningen
JSP-code
Opmaakdefinitie
Taal van het Malplaatje van de HTML(HTML) syntaxis
JSP-code
XSS-ontsmetting
Geautomatiseerd door HTML
Meestal handmatig
Naam van CSS-klassen
Gestandaardiseerde noemende overeenkomst die op Modifier van het Element van het Blok(BEM) (vanaf versie 2.0.0 wordt gebaseerd)
Aangepaste schema's
Dialoogdefinitie
Koraal 3
Koraal 2 + klassieke gebruikersinterface
JSON-uitvoer
Sling Models Exporter met Jackson rangschikking
Standaard Sling-servlet
Versioning
voor het model en HTML
Geen
Testen
Eenheidstests + integratietests
Integratietests
Aflevering
Via openbare GitHub
Via Quickstart
Licentie
Vergunning Apache
Eigen Adobe
Bijdrage
Via pull request
Niet mogelijk
Toegankelijkheid
Volledig volgzaam met de WCAG 2.0 norm van A
Slechts gedeeltelijk volgzaam met de WCAG 2.0 norm van A

Componentlijst component-list

De volgende lijst maakt een lijst van de beschikbare Componenten van de Kern, die met hun API verbinden, en wijst op welke stichtingscomponenten zij vervangen.

Kerncomponent
Beschrijving
Vervangen basiscomponent(en)
Pagina
Responsieve pagina werken met sjablooneditor
/libs/foundation/components/page /libs/wcm/foundation/components/page
Breadcrumb
Navigatie in paginahiërarchie
/libs/foundation/components/breadcrumb
Titel
H1-H6-titel
/libs/foundation/components/title /libs/wcm/foundation/components/title
Tekst
RTF
/libs/foundation/components/text /libs/foundation/components/table /libs/wcm/foundation/components/text
Beeld
Slim en wazig laden van optimale renditiegrootte
/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
Lijst
Lijst met pagina's
/libs/foundation/components/list /libs/foundation/components/mobilelist /libs/wcm/foundation/components/list
Sociale Media diedelen
Delen via facebook en Pinterest
-
de Container van de Vorm
Responsief formulieralineasysteem
/libs/foundation/components/form/start /libs/foundation/components/form/end
Tekst van de Vorm
Tekstinvoerveld
/libs/foundation/components/form/text /libs/foundation/components/form/password
Opties van de Vorm
Invoerveld Meerdere opties
/libs/foundation/components/form/checkbox /libs/foundation/components/form/radio /libs/foundation/components/form/dropdown
Verborgen Vorm
Verborgen invoerveld
/libs/foundation/components/form/hidden
Knop van de Vorm
Verzenden of aangepaste knop
/libs/foundation/components/form/submit
Navigatie
Een sitenavigatie-component die de geneste paginahiërarchie weergeeft
/libs/foundation/components/topnav /libs/foundation/components/mobiletopnav
Navigatie van de Taal
Een taal- en landswitch die de algemene taalstructuur opsomt
-
Snel Onderzoek
Een zoekcomponent die de resultaten als suggesties ter plaatse in een vervolgkeuzemenu weergeeft
/libs/foundation/components/search
Taser
Hiermee kan de auteur van de inhoud eenvoudig een gummetje maken om inhoud te verfijnen met een afbeelding, titel of RTF-tekst en een koppeling maken naar verdere inhoud of andere handelingen
-
Lusjes
Hiermee kan de auteur van de inhoud de pagina-inhoud op meerdere tabbladen ordenen
-
Carousel
Hiermee kan de auteur van de inhoud de inhoud ordenen in een draaiende carrousel van dia's
/libs/foundation/components/carousel
het Fragment van de Inhoud
Hiermee kunt u een inhoudsfragment weergeven
-
Lijst van het Fragment van de Inhoud
Hiermee wordt een lijst met inhoudsfragmenten weergegeven
-
Scheidingsteken
Hiermee wordt de inhoud van een pagina gescheiden
-
Accordeon
Inhoudsdeelvensters ordenen in een inklapbare accordeon
-
Container
Componenten indelen in een container
-
Knoop
Een knop op een pagina maken
-
Download
Een downloadbaar element toevoegen aan een pagina
-
Fragment van de Ervaring
Een ervaringsfragment toevoegen aan een pagina
/libs/cq/experience-fragments/editor/components/experiencefragment
bedin
Een externe bron in een pagina insluiten
-
Bar van de Voortgang
Een visuele weergave geven van de voortgang in de richting van een doel
-
de Kijker van de PDF
Hiermee wordt een PDF-document op een pagina gepresenteerd
-

Upgrade van kerncomponenten upgrade-of-core-components

Een voordeel van versioned componenten is dat het toestaat om de migratie aan een nieuwe AEM versie van de migratie aan nieuwe componentenversies te scheiden. Als er nieuwe componentversies beschikbaar zijn, is het bovendien mogelijk om elke component afzonderlijk naar de nieuwe versie te migreren.

Migraties naar een nieuwe AEM hebben geen invloed op de werking van de Core Components, op voorwaarde dat de versies ervan ook ondersteuning bieden voor de nieuwe AEM die wordt gemigreerd naar. De aanpassingen die aan de Componenten van de Kern worden aangebracht zouden niet of moeten worden beïnvloed, zolang zij geen APIs gebruiken die zijn afgekeurd ofverwijderd.

De migraties aan nieuwe versies van de Componenten van de Kern zullen niet beïnvloeden hoe de component ook werkt, maar de nieuwe eigenschappen zouden aan paginaauteurs kunnen worden geïntroduceerd, die één of andere configuratie door een malplaatjeredacteur zouden kunnen vereisen, voor het geval dat het standaardgedrag niet wordt gewenst. De aanpassingen nochtans zouden moeten worden aangepast, voor meer details zie Aanpassend de pagina van de Componenten van de Kern.

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