Componente Elenco list-component

Il componente core Elenco consente di creare facilmente elenchi dinamici e statici.

Utilizzo usage

Il componente Elenco può essere utilizzato per creare, ad esempio, un elenco dinamico di pagine figlie o un elenco statico di elementi definiti arbitrariamente. Il tipo di elenchi disponibili e le opzioni di formattazione possono essere definiti dall’autore del modello nella finestra di dialogo per progettazione. L’editor di contenuto può scegliere tra i tipi di elenchi disponibili e come formattare gli elementi dell’elenco nella finestra di dialogo per modifica.

Versione e compatibilità version-and-compatibility

La versione corrente del componente Elenco è la v4, introdotta con la versione 2.22.0 dei componenti core di febbraio 2023, 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.

Versione del componente
AEM 6.4
AEM 6.5
AEM as a Cloud Service
v4
-
Compatibile
Compatibile
v3
-
Compatibile
Compatibile
v2
Compatibile
Compatibile
Compatibile
v1
Compatibile
Compatibile
Compatibile

Per ulteriori informazioni sulle versioni e sugli aggiornamenti dei Componenti core, vedi il documento Versioni dei Componenti core.

Reindirizzamenti nei componenti Elenco redirects

Quando una pagina presenta una destinazione di reindirizzamento (che sia verso un URL esterno o un’altra pagina AEM), un elenco che contiene i relativi link punta direttamente all’URL della destinazione di reindirizzamento.

Esempio redirect-example

  • Crea una pagina A che reindirizza alla pagina B.
  • Crea una pagina C che reindirizza a https://aemcomponents.dev
  • In una pagina D, inserisci un componente elenco contenente le pagine A e C
  • I rispettivi link generati puntano direttamente alle pagine B e https://aemcomponents.dev

Esempio di output del componente sample-component-output

Per avere un’idea del componente Elenco 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 Elenco è disponibile su GitHub.

Per ulteriori informazioni sullo sviluppo di Componenti core, vedi la documentazione per gli sviluppatori di Componenti core.

Finestra di dialogo per modifica edit-dialog

La finestra di dialogo per modifica consente all’autore di contenuto di configurare l’elenco e i relativi elementi.

Scheda Impostazioni elenco list-settings-tab

L’elenco può essere creato in diversi modi.

Indipendentemente dalla modalità di creazione dell’elenco, è sempre possibile configurare le opzioni Ordinamento e ID.

Finestra di dialogo per modifica del componente Elenco

A seconda di come l’autore del contenuto sceglie di creare l’elenco, le opzioni di configurazione aggiuntive cambiano.

Pagine figlie child-pages

L’elenco può essere costituito dalle pagine figlie della pagina corrente o di un’altra pagina.

Opzioni per le pagine figlie

  • Pagina padre

    • Pagina da cui creare l’elenco di pagine figlie
    • Lascia il campo vuoto per usare la pagina corrente
  • Profondità elementi figlio
    Quanti livelli della gerarchia devono essere utilizzati

Elenco fisso fixed-list

L’elenco può essere creato utilizzando elementi fissi.

Opzioni per elenco fisso

Tocca il o fai clic sul pulsante Aggiungi per inserire un nuovo elemento nell’elenco.

  • Nel campo Collegamento inserisci

    • un URL completo
    • o un URL relativo al contenuto AEM esistente
      • È possibile utilizzare la Finestra di dialogo per selezione per scegliere un elemento da AEM.
  • Nel campo Testo, immetti nell’elenco il testo da visualizzare per il collegamento.

  • Seleziona la casella di controllo se il collegamento deve essere aperto in una nuova scheda del browser

Una volta creato più di un elemento per l’elenco, è possibile organizzare l’elenco.

  • Utilizza la maniglia di trascinamento per modificare la disposizione degli elementi nell’elenco.
  • Utilizza l’icona cestino per eliminare elementi dall’elenco.

Ricerca search-options

L’elenco può essere creato utilizzando i risultati di una ricerca di contenuto AEM.

Opzioni per la ricerca

  • Query di ricerca
    Stringa per la quale verrà eseguita una ricerca di testo completa per generare gli elementi dell’elenco

  • Cerca in
    Dove eseguire la ricerca

    • Utilizza la finestra di dialogo per selezione per scegliere la posizione in AEM
    • Se non specificata, viene utilizzata la pagina corrente

Tag tags

L’elenco può essere creato utilizzando pagine che corrispondono a determinati tag presenti in una posizione specifica.

Opzioni per i tag

  • Pagina padre
    La pagina da cui inizia la ricerca delle corrispondenze con i tag

    • Utilizza la finestra di dialogo per selezione per scegliere la posizione in AEM
    • Se non specificata, viene utilizzata la pagina corrente
  • Tag
    I tag per i quali deve esistere una corrispondenza

    • Utilizza la finestra di dialogo Sfoglia per selezionare i tag
  • Corrispondenza
    Consente di definire il tipo di corrispondenza da applicare a una pagina da includere nell’elenco

    • qualsiasi tag
    • tutti i tag

Opzioni di ordinamento sort-options

Indipendentemente dalla modalità di creazione dell’elenco, è sempre possibile definire alcune opzioni di ordinamento.

Opzioni di ordinamento

  • Ordina per
    Come ordinare gli elementi

    • Titolo
    • Data ultima modifica
  • Ordinamento
    L’ordine in cui devono essere disposti gli elementi

    • crescente
    • decrescente
  • Max. elementi
    Il numero massimo di elementi da visualizzare nell’elenco.

    • Lascia vuoto il campo per restituire tutti gli elementi.
  • 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 Impostazioni elemento item-settings-tab

Utilizzando la scheda Impostazioni elemento, è possibile configurare la formattazione degli elementi dell’elenco.

Impostazioni elemento

  • Collega elementi - Collega gli elementi alla pagina corrispondente
  • Mostra descrizione - Mostra la descrizione dell’elemento da collegare
  • Mostra data - Mostra la data di modifica dell’elemento da collegare
  • Visualizza come teaser - Se questa opzione è selezionata, l’elemento viene visualizzato come teaser

Scheda Stili styles-tab-edit

Il componente Elenco 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.

Scheda Stili della finestra di dialogo per modifica del componente Elenco

Finestra di dialogo per progettazione design-dialog

La finestra di dialogo per progettazione consente all’autore del modello di definire i tipi di elenchi da consentire agli autori di contenuto e le impostazioni disponibili per gli elementi.

Impostazioni elenco list-settings

Nella scheda Impostazioni elenco, è possibile definire il formato della data e i tipi di elenchi da rendere disponibili nel componente per gli autori di contenuto.

Impostazione dell’elenco nella finestra di dialogo per progettazione del componente Elenco

  • Formato data
    Il formato da utilizzare per visualizzare la data dell’ultima modifica
  • Disabilita elementi figlio
    Disabilita il tipo di elenco figlio nel componente
  • Disabilita statico
    Disabilita il tipo di elenco statico nel componente
  • Disabilita ricerca
    Disabilita il tipo di elenco ricerca nel componente
  • Disabilita tag
    Disabilita il tipo di elenco tag nel componente

Impostazioni elemento item-settings

Nella scheda Impostazioni elemento, è possibile definire le opzioni di formattazione per i singoli elementi dell’elenco che devono essere disponibili nel componente per gli autori di contenuto.

Impostazioni degli elementi nella finestra di dialogo per progettazione del componente Elenco

Scheda Stili styles-tab

Il componente Immagine supporta il sistema di stili di AEM.

Adobe Client Data Layer data-layer

Il componente Elenco supporta Adobe Client Data Layer.

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