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.
- As propriedades da opção de download podem ser selecionadas na caixa de diálogo de configuração.
- Os padrões para o componente de Download podem ser definidos na caixa de diálogo design.
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.
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 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
-
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
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
- 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.