Skapa enkelsidiga program (SPA) med AEM create-spa

I den här valfria fortsättningen av AEM Headless Developer Journeyfår du lära dig hur Adobe Experience Manager (AEM) kan kombinera headless-leverans med traditionella CMS-funktioner i full hög och hur du kan skapa redigerbara SPA med hjälp av AEM ramverk för SPA Editor och integrera externa SPA, vilket möjliggör redigeringsfunktioner efter behov.

Story hittills story-so-far

Nu ska du ha slutfört hela AEM Headless Developer Journey och förstå grunderna för headless delivery i AEM, inklusive en förståelse för:

  • Skillnaden mellan headless och headful content delivery.
  • AEM headless-funktioner.
  • Organisera och AEM Headless-projekt.
  • Skapa innehåll utan rubriker i AEM.
  • Så här hämtar och uppdaterar du headless-innehåll i AEM.
  • Så här lever du med ett AEM Headless-projekt.

Så du har antingen gått live med ditt första projekt AEM Headless eller haft kunskapen om att göra det. Grattis!

Varför läser du den här extra, valfria fortsatta resan? I Getting Started diskuterades troligen hur AEM inte bara har stöd för headless-leverans och traditionella fullstacksmodeller, utan även hybridmodeller som kombinerar fördelarna med båda. Även om det inte är den traditionella headless-modellen kan sådana hybridmodeller ge oöverträffad flexibilitet till vissa projekt.

Den här artikeln bygger på dina kunskaper om AEM Headless genom att ingående utforska hur du kan skapa egna single-page-program (SPA) som kan redigeras i AEM. På så sätt kan du skapa innehåll och skicka det direkt till en SPA, men det SPA fortfarande redigerbart i AEM.

Syfte objective

Det här dokumentet hjälper dig att förstå hur Single Page-program utvecklas med AEM ramverk för SPA. När du har läst det här dokumentet bör du:

  • Förstå den grundläggande funktionen i SPA.
  • Lär dig grunderna för att skapa en fullt redigerbar SPA för AEM.
  • Förstå hur externa SPA kan integreras i AEM.
  • Förstå hur återgivning på serversidan ska implementeras eller inte.

Krav och krav requirements-prerequisites

Det finns flera krav innan du börjar arbeta med SPA i AEM.

Kunskap knowledge

  • Utvecklingserfarenhet som skapar SPA med React- eller Angular-ramverk
  • Grundläggande AEM att skapa innehållsfragment och använda redigeraren
  • Granska dokumentet Headful and Headless in AEM för att förstå de olika nivåerna av SPA integrering som är möjlig.

verktyg tools

  • Sandlådeåtkomst för testning av driftsättning av ditt projekt
  • Lokal utvecklingsinstans för datamodellering och -testning
  • Befintliga externa SPA (valfritt, beroende på vilken integrationsmodell som väljs)
  • AEM Project Archettype

Vad är en SPA? what-is-a-spa

Ett enkelsidigt program (SPA) skiljer sig från en konventionell sida på så sätt att det återges på klientsidan och i första hand är JavaScript-drivet, beroende på Ajax-anrop för att läsa in data och dynamiskt uppdatera sidan. Det mesta eller allt innehåll hämtas en gång på en sida, och ytterligare resurser läses in asynkront efter behov baserat på användarinteraktionen med sidan.

Detta minskar behovet av siduppdatering och ger användaren en upplevelse som är smidig, snabb och som känns mer som en appupplevelse.

Med AEM SPA Editor kan gränssnittsutvecklare skapa SPA som kan integreras i en AEM webbplats, vilket gör att innehållsförfattarna kan redigera SPA innehåll lika enkelt som annat AEM.

Varför en SPA? why-spa

Genom att vara snabbare, smidigare och mer som ett systemspecifikt program blir en SPA en attraktiv upplevelse inte bara för besökaren på webbsidan, utan även för marknadsförare och utvecklare på grund av hur SPA fungerar.

En fullständig beskrivning av SPA och varför du skulle använda dem finns i avsnittet ytterligare resurser för länkar till mer utförlig dokumentation.

Hur AEM hanterar SPA

Utveckla single page-applikationer AEM förutsätter att frontutvecklaren följer vedertagna standarder när han skapar en SPA. Om du som frontendutvecklare följer dessa allmänna bästa metoder och några AEM specifika principer fungerar SPA med AEM och dess innehållsredigeringsfunktioner.

  • Portabilitet - Precis som med andra komponenter ska SPA byggas så att de blir så portabla som möjligt. SPA bör byggas med rörliga och återanvändbara komponenter.
  • AEM Drives Site Structure - Front-end-utvecklaren skapar komponenter och äger sin interna struktur, men använder AEM för att definiera webbplatsens innehållsstruktur.
  • Dynamisk återgivning - All återgivning ska vara dynamisk.
  • Dynamisk routning - SPA ansvarar för routningen och AEM lyssnar på den och hämtar baserat på den. Alla routningar ska också vara dynamiska.

En fullständig beskrivning av hur AEM hanterar SPA finns i avsnittet ytterligare resurser för länkar till mer utförlig dokumentation.

AEM SPA Editor aem-spa-editor

Webbplatser som byggts med vanliga SPA som React och Angular läser in sitt innehåll via dynamisk JSON och tillhandahåller inte den HTML-struktur som krävs för att den AEM sidredigeraren ska kunna placera redigeringskontroller.

Om du vill kunna redigera SPA i AEM måste du mappa mellan JSON-utdata för SPA och innehållsmodellen i den AEM databasen för att kunna spara ändringar i innehållet.

SPA i AEM innehåller ett tunt JS-lager som interagerar med den SPA JS-koden när den läses in i sidredigeraren. Händelser kan skickas med och platsen för redigeringskontrollerna kan aktiveras för redigering i sitt sammanhang. Den här funktionen bygger på API-slutpunktskonceptet för innehållstjänster eftersom innehållet från SPA måste läsas in via innehållstjänster.

En fullständig beskrivning av AEM SPA Editor finns i avsnittet ytterligare resurser för länkar till mer utförlig dokumentation.

Antar befintliga SPA existing-spas

Om du har en befintlig SPA har AEM stöd för att bädda in den i AEM så att den är synlig för innehållsförfattarna i AEM Editor. Det här kan vara användbart om du vill visa innehållet som de skapar via innehållsfragment i slutprogrammet där det kommer att användas.

Om du bara gör små ändringar kan du dessutom aktivera vissa redigeringsmöjligheter för de externa SPA i AEM Editor.

RemotePage-komponenten tillåter återgivning av en extern SPA i AEM.

En fullständig beskrivning av hur du gör en extern SPA redigerbar i AEM finns i avsnittet ytterligare resurser för länkar till mer detaljerad dokumentation.

What's Next what-is-next

Kom igång med att utveckla en egen SPA för AEM genom att läsa följande dokument:

Om du måste anpassa en befintlig SPA för att använda den i AEM, ska du granska följande dokument:

Nedan finns ytterligare resurser som kan fördjupa dig SPA ämnen i AEM.

Ytterligare resurser additional-resources

Nedan följer ytterligare resurser som ger en djupdykning i några koncept som nämns i det här dokumentet.

recommendation-more-help
19ffd973-7af2-44d0-84b5-d547b0dffee2