Componente de imagem de email email-image-component
O Componente de imagem de email é um componente de imagem adaptável que conta com um sistema de edição incorporado.
Uso usage
O Componente de imagem de email permite selecionar imagens adaptáveis e conta com um comportamento responsivo de carregamento sob demanda para o visitante da página, além de um sistema de posicionamento de imagem do tipo “arrastar e soltar” e configurações para o autor de conteúdo.
- As larguras de imagem e as configurações adicionais podem ser definidas pelo autor do modelo na caixa de diálogo de design.
- O editor de conteúdo pode fazer upload ou selecionar ativos na caixa de diálogo de configuração.
Versão e compatibilidade version-and-compatibility
A versão atual do Componente de imagem de email é a v1, introduzida com a versão x dos Componentes principais de email em outubro de 2022, e está descrita neste documento.
A tabela a seguir detalha todas as versões compatíveis do componente, as versões do AEM com as quais as versões do componente são compatíveis e os links para a documentação das versões anteriores.
Para mais informações sobre as versões e lançamentos dos Componentes principais, consulte o documento Versões dos Componentes principais de email.
Recursos responsivos responsive-features
O Componente de imagem de email vem com recursos responsivos robustos e prontos para uso. No nível do modelo da página, a caixa de diálogo de design pode ser usada para definir as larguras padrão do ativo de imagem. O Componente de imagem de email carregará automaticamente a largura correta para exibição, dependendo do tamanho da janela do navegador. À medida que a janela é redimensionada, o Componente de imagem de email carrega dinamicamente o tamanho de imagem correto. Não há necessidade de os desenvolvedores de componentes se preocuparem em definir consultas de mídia personalizadas, pois o Componente de imagem de email já está otimizado para carregar o seu conteúdo.
Além disso, o Componente de imagem de email é compatível com um sistema de carregamento sob demanda, no qual o carregamento do ativo de imagem é adiado até que ela fique visível no navegador, o que aumenta a capacidade de resposta do seu conteúdo.
Suporte ao Dynamic Media dynamic-media
O Componente de imagem de email é compatível com os ativos do Dynamic Media. Quando habilitados, esses recursos oferecem a capacidade de adicionar ativos de imagem do Dynamic Media com um simples arrastar e soltar ou por meio do navegador de ativos, como você faria com qualquer outra imagem. Além disso, modificadores de imagem, predefinições de imagem e cortes inteligentes também são suportados.
Suas experiências de email criadas com os Componentes principais de email podem oferecer recursos de imagens avançados potencializados pela Adobe AI, robustos, de alto desempenho e em várias plataformas do Dynamic Media.
Suporte a SVG svg-support
Os gráficos de vetor dimensionáveis (SVG) são compatíveis com o Componente de imagem de email.
- Tanto o processo de arrastar e soltar um ativo SVG do DAM quanto o de fazer upload de um arquivo SVG de um sistema de arquivos local são compatíveis.
- O arquivo SVG original é transmitido (as transformações são ignoradas).
- Para uma imagem SVG, as “imagens inteligentes” e os “tamanhos inteligentes” são definidos como uma matriz vazia no modelo de imagem.
Segurança security
Por motivos de segurança, o SVG original nunca é chamado diretamente pelo Editor de imagens. É chamado por meio de <img src=“path-to-component”>. Isso impede que o navegador execute qualquer script incorporado no arquivo SVG.
Detalhes técnicos technical-details
A documentação técnica mais recente sobre o Componente de imagem de email pode ser encontrada no GitHub.
Mais detalhes sobre o desenvolvimento dos Componentes principais podem ser encontrados na documentação do desenvolvedor dos Componentes principais.
O componente de Imagem é compatível com microdados de schema.org.
Caixa de diálogo de configuração configure-dialog
O Componente de imagem de email oferece uma caixa de diálogo de configuração, onde a própria imagem é definida juntamente com sua descrição e propriedades básicas.
Guia Ativo asset-tab
-
Herdar imagem em destaque da página - Esta opção usa a imagem em destaque da página vinculada ou da página atual, se a imagem não estiver vinculada.
-
Texto alternativo para acessibilidade - Este campo permite definir uma descrição da imagem para usuários com deficiências visuais.
- Herdar texto alternativo da página - Esta opção utiliza a descrição alternativa do valor do ativo vinculado dos metadados
dc:descriptionno DAM ou da página atual, se nenhum ativo estiver vinculado.
- Herdar texto alternativo da página - Esta opção utiliza a descrição alternativa do valor do ativo vinculado dos metadados
-
Ativos da imagem
- Solte um ativo do navegador de ativos ou toque na opção pesquisar para fazer upload de um sistema de arquivos local.
- Toque ou clique em Limpar para desmarcar a imagem atualmente selecionada.
- Toque ou clique em Editar para gerenciar as representações do ativo no editor de ativos.
-
Não fornecer um texto alternativo - Esta opção marca a imagem a ser ignorada por tecnologias assistivas, como leitores de tela, nos casos em que a imagem é meramente decorativa ou não transmite informações adicionais para a página.
-
Desativar carregamento lento - Essa opção carrega previamente todos os componentes da imagem e não conforme necessário.
Guia Metadados metadata-tab
-
Tipo de predefinição - Define os tipos de predefinições de imagens disponíveis, seja a Predefinição de imagem ou o Corte inteligente, e só estará disponível quando os recursos do Dynamic Media estiverem habilitados.
- Predefinição de imagem - Quando o Tipo de predefinição da Predefinição de imagem é selecionado, a lista suspensa Predefinição de imagem é disponibilizada, permitindo a seleção das predefinições disponíveis do Dynamic Media. Isso só estará disponível se as predefinições forem definidas para o ativo selecionado.
- Corte inteligente - Quando o Tipo de predefinição do Corte inteligente é selecionado, o menu suspenso de Representação é disponibilizado, permitindo a seleção das representações disponíveis do ativo selecionado. Isso só estará disponível se as representações forem definidas para o ativo selecionado.
- Modificadores de imagem - Comandos adicionais de veiculação de imagens do Dynamic Media podem ser definidos aqui, separados por
&, independentemente do Tipo de predefinição selecionado.
-
Legenda - Informações adicionais sobre a imagem, exibida abaixo da imagem por padrão.
- Obter legenda do DAM - Quando marcado, o texto da legenda da imagem será preenchido com o valor dos metadados
dc:titleno DAM. Disponível somente quando um ativo é selecionado a partir do DAM. - Exibir legendas como janelas pop-up - Quando marcada, a legenda não será exibida abaixo da imagem, mas como um pop-up exibido por alguns navegadores ao passar o mouse sobre a imagem.
- Obter legenda do DAM - Quando marcado, o texto da legenda da imagem será preenchido com o valor dos metadados
-
Vinculação - Vincule a imagem a outro recurso.
- Use a caixa de diálogo de seleção para vincular a outro recurso do AEM.
- Se não estiver vinculando a um recurso do AEM, insira o URL absoluto. URLs não absolutos serão interpretados como relativos a AEM.
- Abrir link em nova guia - Esta opção abre o link em uma nova janela do navegador.
-
ID - Essa opção permite controlar o identificador exclusivo do componente no HTML.
- Caso deixado em branco, um ID exclusivo é gerado automaticamente para você e pode ser encontrado ao inspecionar a página resultante.
- Se um ID for especificado, é responsabilidade do autor garantir que ele seja exclusivo.
- A alteração de ID pode afetar o CSS.
-
Fixo com - Essa opção define a largura da imagem (em pixels).
-
Dimensionar imagem até a largura disponível - Essa opção aplica
"width":"100%"ao atributo de estilo da imagem.
Guia Estilos styles-tab-edit
O Componente de imagem de email é compatível com o sistema de estilos do AEM.
Use o menu suspenso para selecionar os estilos que deseja aplicar ao componente. As seleções feitas na caixa de diálogo de edição têm o mesmo efeito das selecionadas na barra de ferramentas do componente.
Os estilos devem ser configurados para esse componente na caixa de diálogo de design para que a guia esteja disponível.
Caixa de diálogo de design design-dialog
Guia Principal main-tab
-
Habilitar recursos DM - Quando marcada, os recursos do Dynamic Media ficam disponíveis.
- Essa opção só é exibida quando o Dynamic Media está habilitado no ambiente.
-
Habilitar imagens otimizadas para web - quando marcada, o serviço de entrega de imagens otimizadas para a Web fornecerá imagens no formato WebP, reduzindo o tamanho das imagens em cerca de 25%.
- Essa opção só está disponível no AEMaaCS.
- Quando a opção estiver desmarcada ou quando o serviço de entrega de imagens otimizadas para a Web não estiver disponível, o Servlet de imagem adaptável será usado.
-
A imagem é decorativa - Define se a opção de imagem decorativa é automaticamente habilitada ao adicionar o componente de Imagem a uma página.
-
Obter texto alternhabilito do DAM - Define se a opção para recuperar o texto alternhabilito do DAM é habilitada automaticamente ao adicionar o componente de Imagem a uma página.
-
Obter legenda do DAM - Define se a opção para recuperar a legenda do DAM é habilitada automaticamente ao adicionar o componente de Imagem a uma página.
-
Exibir legendas como janelas pop-up - Define se a opção para exibir a legenda da imagem como um pop-up será habilitada automaticamente ao adicionar o componente de Imagem a uma página.
-
Redimensionar largura - Esse valor é usado para redimensionar a largura das imagens base que são ativos do DAM.
- A proporção das imagens será preservada.
- Se o valor for maior que a largura real da imagem, ele não terá efeito.
- Esse valor não tem efeito em imagens SVG.
É possível definir uma lista de larguras em pixels para a imagem e o componente carregará automaticamente a largura mais apropriada com base no tamanho do navegador. Essa é uma parte importante dos recursos responsivos do Componente de imagem de email.
-
Larguras - Define uma lista de larguras em pixels para a imagem e o componente carrega automaticamente a largura mais apropriada com base no tamanho do navegador.
-
Toque ou clique no botão Adicionar para adicionar outro tamanho.
- Use as alças para reorganizar a ordem dos tamanhos.
- Use o ícone Excluir para remover uma largura.
-
Por padrão, o carregamento de imagens é adiado até ficarem visíveis.
- Selecione a opção Desativar carregamento lento para carregar as imagens ao carregar a página.
-
-
Qualidade JPEG - O fator de qualidade (porcentagem entre 0 e 100) para imagens JPEG transformadas (por exemplo, dimensionadas ou cortadas).
-
Largura padrão - A largura padrão de imagens (em pixels) que será usada na caixa de diálogo de design
Guia Estilos styles-tab
O Componente de imagem de email é compatível com o sistema de estilos do AEM.