Componente Scarica download-component
Il componente core Scarica consente di creare un’opzione di scaricamento su una pagina.
Utilizzo usage
Il componente core Scarica consente di includere in una pagina un’opzione di scaricamento e la relativa risorsa associata.
- Le proprietà dell’opzione Scarica possono essere selezionate nella finestra di dialogo finestra di dialogo per configurazione.
- I valori predefiniti del componente Scarica possono essere definiti nella finestra di dialogo per progettazione.
Versione e compatibilità version-and-compatibility
La versione corrente del componente Scarica è la v2, introdotta con la versione 2.18.0 dei Componenti core a febbraio 2022, ed è quella descritta in questo documento.
La tabella che segue descrive tutte le versioni supportate del componente, le versioni di AEM con cui le versioni del componente sono compatibili e i collegamenti alla documentazione delle versioni precedenti.
Per ulteriori informazioni sulle versioni e sugli aggiornamenti dei Componenti core, vedi il documento Versioni dei Componenti core.
Esempio di output del componente sample-component-output
Per avere un’idea del componente Scarica e vedere esempi delle opzioni di configurazione e dell’output HTML e JSON, visita la libreria dei componenti.
Dettagli tecnici technical-details
La documentazione tecnica più recente sul componente Scarica è disponibile su GitHub.
Per ulteriori informazioni sullo sviluppo di Componenti core, vedi la documentazione per gli sviluppatori di Componenti core.
Finestra di dialogo per configurazione configure-dialog
La finestra di dialogo per configurazione consente all’autore di contenuto di definire l’elemento Scarica e il suo comportamento e aspetto nei confronti di chi visita la pagina.
Scheda Risorsa asset-tab
La selezione di una risorsa da scaricare è molto simile alla funzionalità del componente Immagine e allo stesso modo sfrutta il DAM di AEM.
-
Scarica risorsa
- Rilascia una risorsa dal browser di risorse oppure tocca l’opzione Sfoglia per caricarla da un file system locale.
- Tocca o fai clic su Cancella per deselezionare l’immagine attualmente selezionata.
- Tocca o fai clic su Modifica per gestire i rendering della risorsa nell’editor risorse.
Scheda Proprietà properties-tab
-
Titolo: viene visualizzato come titolo dell’elemento da scaricare
- Ottieni titolo da risorsa DAM: se selezionata, viene inserito automaticamente il titolo della risorsa DAM.
-
Descrizione: il sottotitolo descrittivo dell’elemento da scaricare
- Ottieni descrizione da risorsa DAM: se selezionata, viene inserita automaticamente la descrizione della risorsa DAM.
-
Testo azione: il testo dell’azione per l’elemento da scaricare
- Questo campo è necessario per caricare una risorsa dal file system.
- Visualizza in linea: se selezionata, il testo specificato in Testo azione viene visualizzato in linea.
-
ID: questa opzione consente di controllare l’identificatore univoco del componente nel codice HTML e in Data Layer.
- Se non specificato, viene generato automaticamente un ID univoco reperibile sulla pagina risultante.
- Se l’ID viene specificato, è responsabilità dell’autore accertarsi che sia univoco.
- La modifica dell’ID può avere un impatto sul tracciamento di CSS, JS e Data Layer.
Scheda Stili styles-tab-edit
Il componente Scarica supporta il sistema di stili di AEM.
Utilizza il menu a discesa per selezionare gli stili da applicare al componente. Le selezioni effettuate nella finestra di dialogo di modifica hanno lo stesso effetto di quelle selezionate nella barra degli strumenti del componente.
Gli stili devono essere configurati per questo componente nella finestra di dialogo di progettazione affinché il menu a discesa sia disponibile.
Finestra di dialogo per progettazione design-dialog
La finestra di dialogo di progettazione consente all’autore del modello di definire le opzioni disponibili per l’autore di contenuto che utilizza il componente Scarica.
Scheda Proprietà properties-tab-design
- Consenti caricamento dal file system: consente all’autore di contenuto di caricare una risorsa dal proprio file system locale come risorsa da scaricare.
- Per impostazione predefinita, questa opzione è deselezionata.
- Tipo di titolo: l’elemento HTML utilizzato per il titolo del componente Scarica.
- Se non specificato, il valore predefinito è H3.
- Visualizza dimensione file: se selezionata, la dimensione del file della risorsa viene visualizzata nel componente Scarica.
- Per impostazione predefinita, questa opzione è selezionata.
- Visualizza formato file: se selezionata, il formato del file della risorsa viene visualizzato nel componente Scarica.
- Per impostazione predefinita, questa opzione è selezionata.
- Visualizza Nome file: se selezionata, il nome del file della risorsa viene visualizzato nel componente Scarica.
- Per impostazione predefinita, questa opzione è selezionata.
Scheda Stili styles-tab
Il componente Immagine supporta il sistema di stili di AEM.