Composite Components em SPAs composite-components-in-spas

Os componentes compostos usam a natureza modular dos componentes AEM ao combinar vários componentes básicos em um único componente. Um caso de uso comum de componente composto é o componente de cartão, composto por uma combinação dos componentes de imagem e texto.

Quando os componentes compostos são implementados corretamente na estrutura do Editor de aplicativo de página única (SPA) do AEM, os autores de conteúdo podem arrastar e soltar esses componentes como fariam com qualquer outro componente, mas ainda têm a capacidade de editar individualmente cada componente que compõe o componente composto.

Este artigo demonstra como você pode adicionar um componente composto ao aplicativo de página única para funcionar perfeitamente com o Editor SPA do AEM.

Caso de uso use-case

Este artigo usará o componente de cartão típico como exemplo de caso de uso. Os cartões são um elemento comum da interface do usuário para muitas experiências digitais e geralmente são compostos de uma imagem e texto ou legenda associados. Um autor deseja poder arrastar e soltar todo o cartão, mas poder editar individualmente a imagem do cartão e personalizar o texto associado.

Pré-requisitos prerequisites

Os seguintes modelos de suporte para casos de uso de componentes compostos exigem os seguintes pré-requisitos.

Adicionar componentes compostos a um SPA adding-composite-components

Há três modelos diferentes para implementar seu componente composto, dependendo de sua implementação de SPA no AEM.

As seções a seguir fornecem exemplos de implementação de cada caso usando o componente de cartão como exemplo.

O componente não existe em seu projeto do AEM. component-does-not-exist

Comece criando os componentes que compõem o componente composto, ou seja, os componentes da imagem e seu texto.

O componente de texto será semelhante ao seguinte.

import React from 'react';
import { withMappable } from '@adobe/aem-react-editable-components';

export const TextEditConfig = {
  emptyLabel: 'Text',
  isEmpty: function(props) {
    return !props || !props.text || props.text.trim().length < 1;
  },
  resourceType: 'wknd-spa/components/text'
};

export const Text = ({ cqPath, richText, text }) => {
  const richTextContent = () => (
    <div className="aem_text"
      id={cqPath.substr(cqPath.lastIndexOf('/') + 1)}
      data-rte-editelement
      dangerouslySetInnerHTML={{__html: text}} />
  );
  return richText ? richTextContent() : (
     <div className="aem_text">{text}</div>
  );
};

export const AEMText = withMappable(Text, TextEditConfig);

Se você criar um componente de imagem de maneira semelhante, poderá combiná-lo com o componente AEMText em um novo componente de cartão, usando os componentes de imagem e texto como filhos.

import React from 'react';
import { AEMText } from './AEMText';
import { AEMImage } from './AEMImage';

export const AEMCard = ({ pagePath, itemPath}) => (
  <div>
    <AEMText
       pagePath={pagePath}
       itemPath={`text`} />
    <AEMImage
       pagePath={pagePath}
       itemPath={`image`} />
   </div>
);

Esse componente composto resultante agora pode ser colocado em qualquer lugar no aplicativo e o adicionará espaços reservados para um componente de texto e imagem no Editor de SPA. Na amostra abaixo, o componente de cartão é adicionado ao componente inicial abaixo do título.

function Home() {
  return (
    <div className="Home">
      <h2>Current Adventures</h2>
      <AEMCard
        pagePath='/content/wknd-spa/home' />
    </div>
  );
}

Isso exibirá um espaço reservado vazio para um texto e uma imagem no editor. Ao inserir valores para eles usando o editor, eles são armazenados no caminho de página especificado, ou seja, /content/wknd-spa/home no nível raiz com os nomes especificados em itemPath.

O componente existe em seu projeto do AEM, mas o conteúdo necessário não existe. content-does-not-exist

Nesse caso, o componente de cartão já foi criado no projeto do AEM que contém os nós de título e imagem. Os nós secundários (texto e imagem) têm os tipos de recursos correspondentes.

Em seguida, é possível adicioná-lo ao SPA e recuperar o conteúdo.

Agora, o componente imagecard pode ser adicionado diretamente ao contêiner no editor do AEM.

O componente e seu conteúdo necessário existem no projeto do AEM. both-exist

Se o conteúdo existir no AEM, ele poderá ser incluído diretamente no SPA fornecendo o caminho para o conteúdo.

<AEMCard
    pagePath='/content/wknd-spa/home'
    itemPath='root/responsivegrid/imagecard' />

O componente AEMCard é o mesmo definido ​ no caso de uso anterior. Aqui o conteúdo definido no local acima no projeto do AEM está incluído no SPA.