Mappatura di componenti SPA per AEM componenti

Scopri come mappare i componenti React ai componenti di Adobe Experience Manager (AEM) con l’SDK JS dell’editor di AEM SPA. La mappatura dei componenti consente agli utenti di apportare aggiornamenti dinamici ai componenti SPA all’interno dell’editor di SPA AEM, in modo simile all’authoring tradizionale AEM.

Questo capitolo descrive in modo più approfondito l’API del modello JSON AEM e come il contenuto JSON esposto da un componente AEM può essere inserito automaticamente in un componente React come prop.

Obiettivo

  1. Scopri come mappare AEM componenti su SPA componenti.
  2. Come un componente React utilizza le proprietà dinamiche passate da AEM.
  3. Scopri come utilizzare la funzionalità integrata Reazione AEM componenti core.

Cosa verrà creato

In questo capitolo viene esaminato il modo in cui il Text SPA componente è mappato al AEM Textcomponente. Reazione dei componenti core come Image SPA componente viene utilizzato nella SPA e creato in AEM. Funzioni predefinite del Contenitore di layout e Editor modelli I criteri vengono inoltre utilizzati per creare una visualizzazione con un aspetto leggermente più vario.

Esempio di capitolo di authoring finale

Prerequisiti

Rivedere gli strumenti e le istruzioni necessari per la configurazione di un ambiente di sviluppo locale. Il presente capitolo costituisce la continuazione del Integrare il SPA capitolo, tuttavia per seguire tutto ciò che serve è un progetto AEM abilitato SPA.

Approccio di mappatura

Il concetto di base consiste nel mappare un componente SPA a un componente AEM. AEM componenti, esegui lato server, esporta il contenuto come parte dell’API del modello JSON. Il contenuto JSON viene utilizzato dal SPA, che esegue lato client nel browser. Viene creata una mappatura 1:1 tra SPA componenti e un componente AEM.

Panoramica di alto livello sulla mappatura di un componente AEM a un componente React

Panoramica di alto livello sulla mappatura di un componente AEM a un componente React

Inspect come componente testo

La Archetipo di progetto AEM fornisce un Text componente mappato al AEM Componente testo. Questo è un esempio di content componente, in quanto esegue il rendering content da AEM.

Vediamo come funziona il componente.

Inspect il modello JSON

  1. Prima di passare al codice SPA, è importante comprendere il modello JSON AEM fornito. Passa a Libreria dei componenti core e visualizzare la pagina del componente Testo . La libreria dei componenti core fornisce esempi di tutti i componenti core AEM.

  2. Seleziona la JSON per uno degli esempi:

    Modello JSON per testo

    Dovresti visualizzare tre proprietà: text, richTexte :type.

    :type è una proprietà riservata che elenca i sling:resourceType (o percorso) del componente AEM. Il valore di :type viene utilizzato per mappare il componente AEM al componente SPA.

    text e richText sono proprietà aggiuntive esposte al componente SPA.

  3. Visualizza l’output JSON in http://localhost:4502/content/wknd-spa-react/us/en.model.json. Dovresti trovare una voce simile a:

    "text": {
        "id": "text-a647cec03a",
        "text": "<p>Hello World! Updated content!</p>\r\n",
        "richText": true,
        ":type": "wknd-spa-react/components/text",
        "dataLayer": {}
       }
    

Inspect il componente Testo SPA

  1. Nell’IDE che preferisci, apri il Progetto AEM per l’SPA. Espandi la ui.frontend modulo e apri il file Text.js sotto ui.frontend/src/components/Text/Text.js.

  2. La prima area che esamineremo è la class Text a ~linea 40:

    class Text extends Component {
    
        get richTextContent() {
            return (<div
                    id={extractModelId(this.props.cqPath)}
                    data-rte-editelement
                    dangerouslySetInnerHTML={{__html: DOMPurify.sanitize(this.props.text)}} />
                    );
        }
    
        get textContent() {
            return <div>{this.props.text}</div>;
        }
    
        render() {
            return this.props.richText ? this.richTextContent : this.textContent;
        }
    }
    

    Text è un componente React standard. Il componente utilizza this.props.richText per determinare se il contenuto di cui eseguire il rendering sarà RTF o testo normale. Il "contenuto" effettivamente utilizzato proviene da this.props.text.

    Per evitare un potenziale attacco XSS, il testo RTF viene evitato tramite DOMPurify prima di utilizzare pericolosamenteSetInnerHTML per eseguire il rendering del contenuto. Richiama richText e text proprietà del modello JSON illustrato in precedenza nell’esercizio.

  3. Apri ui.frontend/src/components/import-components.js dai un'occhiata al TextEditConfig alla ~riga 86:

    const TextEditConfig = {
    emptyLabel: 'Text',
    
        isEmpty: function(props) {
            return !props || !props.text || props.text.trim().length < 1;
        }
    };
    

    Il codice riportato sopra ha la responsabilità di determinare quando eseguire il rendering del segnaposto nell’ambiente di authoring AEM. Se la isEmpty restituisce il metodo true quindi viene eseguito il rendering del segnaposto.

  4. Infine, dai un'occhiata al MapTo chiama a ~line 94:

    export default MapTo('wknd-spa-react/components/text')(LazyTextComponent, TextEditConfig);
    

    MapTo è fornito dall’SDK JS dell’editor SPA AEM (@adobe/aem-react-editable-components). Il percorso wknd-spa-react/components/text rappresenta sling:resourceType del componente AEM. Questo percorso viene associato al :type esposto dal modello JSON osservato in precedenza. MapTo si occupa di analizzare la risposta del modello JSON e passare i valori corretti come props al componente SPA.

    Puoi trovare il AEM Text definizione del componente in ui.apps/src/main/content/jcr_root/apps/wknd-spa-react/components/text.

Utilizzare i componenti core React

AEM componenti WCM - Implementazione di React Core e AEM componenti WCM - Editor Spa - Implementazione react Core. Si tratta di un set di componenti dell’interfaccia utente riutilizzabili che vengono mappati su componenti AEM predefiniti. La maggior parte dei progetti può riutilizzare questi componenti come punto di partenza per la propria implementazione.

  1. Nel codice del progetto apri il file . import-components.js a ui.frontend/src/components.
    Questo file importa tutti i componenti SPA che vengono mappati su componenti AEM. Data la natura dinamica dell’implementazione dell’editor di SPA, dobbiamo fare riferimento esplicitamente a qualsiasi componente SPA legato a componenti AEM modificabili dall’autore. Questo consente all’autore AEM di scegliere di utilizzare un componente ovunque si desideri nell’applicazione.

  2. Le seguenti istruzioni di importazione includono SPA componenti scritti nel progetto:

    import './Page/Page';
    import './Text/Text';
    import './Container/Container';
    import './ExperienceFragment/ExperienceFragment';
    
  3. Ce ne sono molti altri imports da @adobe/aem-core-components-react-spa e @adobe/aem-core-components-react-base. Si tratta dell’importazione dei componenti React Core e della loro disponibilità nel progetto corrente. Questi vengono quindi mappati su componenti AEM specifici del progetto utilizzando MapTo, proprio come con la Text esempio precedente.

Aggiorna criteri AEM

I criteri sono una funzione dei modelli AEM che offre agli sviluppatori e agli utenti un controllo granulare sui componenti disponibili per l’utilizzo. I componenti core React sono inclusi nel codice SPA ma devono essere attivati tramite un criterio prima di poter essere utilizzati nell’applicazione.

  1. Dalla schermata iniziale AEM passare a Strumenti > Modelli > Reazione SPA WKND.

  2. Seleziona e apri la Pagina SPA modello per la modifica.

  3. Seleziona la Contenitore di layout e clicca su policy per modificare il criterio:

    criterio contenitore layout

  4. Sotto Componenti consentiti > Reazione SPA WKND - Contenuto > controlla Immagine, Teaser e Titolo.

    Componenti aggiornati disponibili

    Sotto Componenti predefiniti > Aggiungi mappatura e scegli la Immagine - Reazione SPA WKND - Contenuto componente:

    Imposta componenti predefiniti

    Inserisci un tipo mime di image/*.

    Fai clic su Fine per salvare gli aggiornamenti dei criteri.

  5. In Contenitore di layout fai clic su policy per Testo componente.

    Crea un nuovo criterio denominato Testo WKND SPA. Sotto Plug-in > Formattazione > seleziona tutte le caselle per abilitare ulteriori opzioni di formattazione:

    Abilita formattazione RTE

    Sotto Plug-in > Stili paragrafo > seleziona la casella per Abilitare gli stili di paragrafo:

    Abilita stili di paragrafo

    Fai clic su Fine per salvare l'aggiornamento dei criteri.

Contenuto autore

  1. Passa a Homepage http://localhost:4502/editor.html/content/wknd-spa-react/us/en/home.html.

  2. Ora dovresti essere in grado di utilizzare i componenti aggiuntivi Immagine, Teaser e Titolo sulla pagina.

    Componenti aggiuntivi

  3. Inoltre, dovresti essere in grado di modificare il Text e aggiungi altri stili di paragrafo in a schermo intero modalità.

    Modifica RTF a schermo intero

  4. È inoltre necessario essere in grado di trascinare e rilasciare un’immagine dal Ricerca risorse:

    Trascina immagine

  5. Esperienza con Titolo e Teaser componenti.

  6. Aggiungi immagini personalizzate tramite AEM Assets o installa la base di codice finita per lo standard Sito di riferimento WKND. La Sito di riferimento WKND include molte immagini che possono essere riutilizzate sul SPA WKND. Il pacchetto può essere installato utilizzando Gestione pacchetti AEM.

    Package Manager installa wknd.all

Inspect il contenitore di layout

Supporto per Contenitore di layout viene fornito automaticamente dall’SDK dell’editor SPA AEM. La Contenitore di layout, come indicato dal nome, è un container componente. I componenti contenitore sono componenti che accettano strutture JSON che rappresentano altro e crearli in modo dinamico.

Esaminiamo ulteriormente il Contenitore di layout.

  1. In un browser, passa a http://localhost:4502/content/wknd-spa-react/us/en.model.json

    API del modello JSON - Griglia reattiva

    La Contenitore di layout un componente sling:resourceType di wcm/foundation/components/responsivegrid e viene riconosciuto dall’editor SPA utilizzando :type proprio come la proprietà Text e Image componenti.

    Le stesse funzionalità di ridimensionamento di un componente utilizzando Modalità Layout sono disponibili con l’editor SPA.

  2. Torna a http://localhost:4502/editor.html/content/wknd-spa-react/us/en/home.html. Aggiungi aggiuntivo Immagine e provare a ridimensionarli utilizzando Layout opzione:

    Ridimensionare l’immagine utilizzando la modalità Layout

  3. Riaprire il modello JSON http://localhost:4502/content/wknd-spa-react/us/en.model.json e osservano columnClassNames come parte del JSON:

    Nomi delle classi cloud

    Nome della classe aem-GridColumn--default--4 indica che il componente deve essere largo 4 colonne in base a una griglia a 12 colonne. Maggiori dettagli sulla la griglia reattiva si trova qui.

  4. Torna all’IDE e nella ui.apps nel modulo è presente una libreria lato client definita in ui.apps/src/main/content/jcr_root/apps/wknd-spa-react/clientlibs/clientlib-grid. Aprire il file less/grid.less.

    Questo file determina i punti di interruzione (default, tablete phone) utilizzata dal Contenitore di layout. Questo file deve essere personalizzato in base alle specifiche del progetto. Attualmente i punti di interruzione sono impostati su 1200px e 768px.

  5. Dovresti essere in grado di utilizzare le funzionalità reattive e i criteri rich text aggiornati della Text per creare una visualizzazione come segue:

    Esempio di capitolo di authoring finale

Congratulazioni!

Congratulazioni, hai imparato a mappare SPA componenti su componenti AEM e hai utilizzato i componenti core React. Hai anche la possibilità di esplorare le funzionalità reattive di Contenitore di layout.

Passaggi successivi

Navigazione e instradamento - Scopri come è possibile supportare più visualizzazioni nel SPA mappando le pagine AEM con l’SDK dell’editor SPA. La navigazione dinamica è implementata utilizzando i componenti core React Router e React.

(Bonus) Persistere configurazioni al controllo del codice sorgente

In molti casi, specialmente all’inizio di un progetto AEM, è utile mantenere le configurazioni, come i modelli e i relativi criteri dei contenuti, al controllo del codice sorgente. In questo modo tutti gli sviluppatori lavorano con lo stesso set di contenuti e configurazioni e possono garantire un’ulteriore coerenza tra gli ambienti. Quando un progetto raggiunge un certo livello di maturità, la gestione dei modelli può essere affidata a un gruppo speciale di utenti.

I passaggi successivi verranno eseguiti utilizzando l'IDE di codice di Visual Studio e Sincronizzazione AEM VSCode ma potrebbe utilizzare qualsiasi strumento e qualsiasi IDE configurato per tirare o importare contenuto da un’istanza locale di AEM.

  1. Nell'IDE di codice di Visual Studio, verificare di disporre di Sincronizzazione AEM VSCode installato tramite l’estensione Marketplace :

    Sincronizzazione AEM VSCode

  2. Espandi la ui.content modulo in Project explorer e passa a /conf/wknd-spa-react/settings/wcm/templates.

  3. Clic con il pulsante destro la templates e seleziona Importa da AEM server:

    Modello di importazione VSCode

  4. Ripeti i passaggi per importare il contenuto, ma seleziona la politiche cartella situata in /conf/wknd-spa-react/settings/wcm/templates/policies.

  5. Inspect filter.xml file situato in ui.content/src/main/content/META-INF/vault/filter.xml.

    <!--ui.content filter.xml-->
    <?xml version="1.0" encoding="UTF-8"?>
     <workspaceFilter version="1.0">
         <filter root="/conf/wknd-spa-react" mode="merge"/>
         <filter root="/content/wknd-spa-react" mode="merge"/>
         <filter root="/content/dam/wknd-spa-react" mode="merge"/>
         <filter root="/content/experience-fragments/wknd-spa-react" mode="merge"/>
     </workspaceFilter>
    

    La filter.xml Il file è responsabile dell’identificazione dei percorsi dei nodi installati con il pacchetto. Osserva che mode="merge" in ciascuno dei filtri che indica che il contenuto esistente non verrà modificato, viene aggiunto solo un nuovo contenuto. Poiché gli autori dei contenuti possono aggiornare questi percorsi, è importante che la distribuzione del codice lo faccia not sovrascrivi il contenuto. Consulta la sezione Documentazione FileVault per ulteriori informazioni sull’utilizzo degli elementi filtro.

    Confronto ui.content/src/main/content/META-INF/vault/filter.xml e ui.apps/src/main/content/META-INF/vault/filter.xml per comprendere i diversi nodi gestiti da ciascun modulo.

(Bonus) Crea componente immagine personalizzato

Un componente Immagine SPA è già stato fornito dai componenti React Core. Tuttavia, se desideri una procedura aggiuntiva, crea la tua implementazione React mappata sul AEM Componente immagine. La Image è un altro esempio di content componente.

Inspect JSON

Prima di passare al codice SPA, controlla il modello JSON fornito da AEM.

  1. Passa a Esempi di immagini nella libreria Componenti core.

    JSON del componente core immagine

    Proprietà di src, alte title vengono utilizzati per popolare il SPA Image componente.

    NOTA

    Sono state esposte altre proprietà Immagine (lazyEnabled, widths) che consente a uno sviluppatore di creare un componente adattivo e a caricamento lento. Il componente creato in questa esercitazione è semplice e funziona not utilizza queste proprietà avanzate.

Implementare il componente Immagine

  1. Quindi, crea una nuova cartella denominata Image sotto ui.frontend/src/components.

  2. Sotto Image creare un nuovo file denominato Image.js.

    File Image.js

  3. Aggiungi quanto segue import dichiarazioni a Image.js:

    import React, {Component} from 'react';
    import {MapTo} from '@adobe/aem-react-editable-components';
    
  4. Quindi aggiungi la ImageEditConfig per determinare quando visualizzare il segnaposto in AEM:

    export const ImageEditConfig = {
    
        emptyLabel: 'Image',
    
        isEmpty: function(props) {
            return !props || !props.src || props.src.trim().length < 1;
        }
    };
    

    Il segnaposto mostrerà se il src non è impostata.

  5. Implementare successivamente Image Classe:

     export default class Image extends Component {
    
        get content() {
            return <img     className="Image-src"
                            src={this.props.src}
                            alt={this.props.alt}
                            title={this.props.title ? this.props.title : this.props.alt} />;
        }
    
        render() {
            if(ImageEditConfig.isEmpty(this.props)) {
                return null;
            }
    
            return (
                    <div className="Image">
                        {this.content}
                    </div>
            );
        }
    }
    

    Il codice di cui sopra eseguirà il rendering di un <img> in base alle proprietà src, alte title passato dal modello JSON.

  6. Aggiungi il MapTo codice per mappare il componente React al componente AEM:

    MapTo('wknd-spa-react/components/image')(Image, ImageEditConfig);
    

    Nota la stringa wknd-spa-react/components/image corrisponde alla posizione del componente AEM in ui.apps a: ui.apps/src/main/content/jcr_root/apps/wknd-spa-react/components/image.

  7. Crea un nuovo file denominato Image.css nella stessa directory e aggiungi quanto segue:

    .Image-src {
        margin: 1rem 0;
        width: 100%;
        border: 0;
    }
    
  8. In Image.js aggiungi un riferimento al file nella parte superiore sotto la import dichiarazioni:

    import React, {Component} from 'react';
    import {MapTo} from '@adobe/aem-react-editable-components';
    
    require('./Image.css');
    
  9. Apri il file . ui.frontend/src/components/import-components.js e aggiungi un riferimento al nuovo Image componente:

    import './Page/Page';
    import './Text/Text';
    import './Container/Container';
    import './ExperienceFragment/ExperienceFragment';
    import './Image/Image'; //add reference to Image component
    
  10. In import-components.js commenta l’immagine del componente core React:

    //MapTo('wknd-spa-react/components/image')(ImageV2, {isEmpty: ImageV2IsEmptyFn});
    

    In questo modo verrà utilizzato il componente Immagine personalizzato.

  11. Dalla radice del progetto distribuisci il codice SPA per AEM utilizzando Maven:

    $ cd aem-guides-wknd-spa.react
    $ mvn clean install -PautoInstallSinglePackage
    
  12. Inspect il SPA in AEM. Eventuali componenti Immagine nella pagina continueranno a funzionare. Inspect visualizza l’output di cui è stato effettuato il rendering ed è necessario visualizzare il markup per il componente Immagine personalizzato invece del componente core React.

    Marcatura del componente Immagine personalizzato

    <div class="Image">
        <img class="Image-src" src="/content/image-src.jpg">
    </div>
    

    Marcatura immagine del componente core React

    <div class="cmp-image cq-dd-image">
        <img src="/content/image-src.jpg" class="cmp-image__image">
    </div>
    

    Questa è una buona introduzione all’estensione e all’implementazione dei componenti personalizzati.

In questa pagina