Componente de Download download-component

O componente de Download, dos Componentes principais, permite a criação de uma opção de download em uma página.

Uso usage

O componente de Download, dos Componente principais, permite a inclusão de uma opção de download e de seu ativo associado em uma página.

Versão e compatibilidade version-and-compatibility

A versão atual do componente de download é a v2, introduzida com a versão 2.18.0 dos componentes principais em fevereiro 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.

Versão do componente
AEM 6.4
AEM 6.5
AEM as a Cloud Service
v2
-
Compatível
Compatível
v1
Compatível
Compatível
Compatível

Para mais informações sobre as versões dos Componentes principais, consulte o documento Versões dos Componentes principais.

Exemplo de saída do componente sample-component-output

Para experimentar o componente de Download, e ver exemplos de suas opções de configuração e de saídas HTML e JSON, visite a Biblioteca de Componentes.

Detalhes técnicos technical-details

A documentação técnica mais recente sobre o componente de Download pode ser encontrada no GitHub.

Mais detalhes sobre o desenvolvimento dos Componentes principais podem ser encontrados na documentação do desenvolvedor dos Componentes principais.

Caixa de diálogo de configuração configure-dialog

A caixa de diálogo de configuração permite que o autor de conteúdo defina o item de download e como ele se comportará e será exibido para um visitante da página.

Guia Ativo, da caixa de diálogo de edição, do componente de download

Guia Ativo asset-tab

A seleção de um ativo de download é muito semelhante à funcionalidade do Componente de imagem, aproveitando também o DAM do AEM.

  • Baixar ativo

    • 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.

Guia Propriedades properties-tab

Guia Propriedades da caixa de diálogo de edição do componente de Download

  • Título - exibido como um título para o item de download

    • Obter o título do ativo DAM - Quando selecionado, o título é preenchido automaticamente com o título do ativo DAM.
  • Descrição - É exibido como um subtítulo descritivo do item de download

    • Obter a descrição do ativo DAM - Quando selecionada, a descrição é preenchida automaticamente com a descrição do ativo DAM.
  • Texto de ação - É exibido como texto de ação para o item de download

    • Esse campo é necessário ao fazer upload de um ativo do sistema de arquivos.
    • Exibir em linha - Quando selecionado, o Texto de ação fornecido será exibido em linha.
  • ID - Essa opção permite controlar o identificador exclusivo do componente no HTML e na Camada de Dados.

    • 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 do ID pode afetar o rastreamento de CSS, JS e da Camada de Dados.

Guia Estilos styles-tab-edit

Guia Estilos da caixa de diálogo de edição do componente de download

O componente de download é 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 o menu suspenso fique disponível.

Caixa de diálogo de design design-dialog

A caixa de diálogo de design permite que o autor do modelo defina as opções disponíveis para o autor de conteúdo que usa o componente de Download.

Guia Propriedades properties-tab-design

Caixa de diálogo design do componente de Download

  • Permitir o upload por meio do sistema de arquivos - Permite que o autor de conteúdo faça upload de um ativo do sistema de arquivos local como o ativo de download.
    • O valor padrão não está selecionado.
  • Tipo de título - O elemento HTML usado para o título do componente de Download.
    • Se nenhum valor for selecionado, o valor padrão será H3.
  • Tamanho do arquivo de exibição - Quando selecionado, o tamanho do arquivo do ativo será exibido no componente de Download.
    • O valor padrão está selecionado.
  • Formato de arquivo de exibição - Quando selecionado, o formato de arquivo do ativo será exibido no componente de Download.
    • O valor padrão está selecionado.
  • Exibir nome de arquivo - Quando selecionado, o nome do arquivo do ativo será exibido no componente de Download.
    • O valor padrão está selecionado.

Guia Estilos styles-tab

O componente de Imagem é compatível com o Sistema de Estilos do AEM.

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