Controllo Raccolta in Power Apps

  • Articolo

Controllo che contiene altri controlli e mostra un set di dati.

Descrizione

In un controllo Raccolta possono essere visualizzati più record da un'origine dati e ogni record può contenere più tipi di dati. Ad esempio, usa il controllo Raccolta per mostrare più contatti con ogni elemento che mostra le informazioni di contatto che includono nome, indirizzo e un numero di telefono per ogni contatto.

Ogni campo di dati viene visualizzato in un controllo separato all'interno del controllo Raccolta. E puoi configurare quei controlli nel modello. Il modello appare come primo elemento all'interno della raccolta:

  • Sul bordo sinistro di un controllo Raccolta in orientamento orizzontale.
  • E nella parte superiore di un controllo Raccolta in orientamento verticale.

Le modifiche apportate nel modello si riflettono in tutto il controllo Raccolta.

Sono disponibili modelli predefiniti per la visualizzazione di immagini e testo disponibili in una raccolta e una raccolta con elementi di altezza variabile.

Limitazioni

  • Se un utente scorre il controllo della raccolta Altezza flessibile prima che tutti gli elementi vengano caricati, l'elemento che è attualmente nella visualizzazione può essere spostato verso il basso e fuori dalla visualizzazione al termine del caricamento dei dati. Per evitare questo problema, utilizza un controllo Raccolta standard invece della variante Altezza flessibile.
  • I seguenti controlli non sono supportati all'interno di una raccolta:
  • Puoi aggiungere solo una raccolta all'interno di un'altra raccolta.
  • Il minimo TemplateSize è uno. Ciò può far deviare i controlli nella Raccolta dei valori X o Y previsti, quando non si tiene conto delle dimensioni del modello.

Proprietà chiave

Default: l'elemento o il record dall'origine dati da selezionare nella raccolta all'avvio dell'app.

Items: origine dei dati visualizzati in un controllo, ad esempio una raccolta, un elenco o un grafico.

Selected: elemento selezionato.

Proprietà aggiuntive

AccessibleLabel: etichetta della raccolta (non degli elementi che contiene) per le utilità per la lettura dello schermo. Deve descrivere il contenuto dell'elenco di elementi.

AllItems – Elementi caricati nella raccolta. Questo valore potrebbe essere inferiore al numero effettivo di elementi dell'origine dati. È possibile caricare più elementi quando si scorre la raccolta. AllItems contiene anche controlli utilizzati in ogni elemento della raccolta.

AllItemsCount: numero di elementi caricati nella galleria. Questo valore potrebbe essere inferiore al numero effettivo di elementi dell'origine dati. È possibile caricare più elementi quando si scorre la raccolta.

BorderColor: colore del bordo di un controllo.

BorderStyle: indica se il bordo di un controllo è Solid (Tinta unita), Dashed (Tratteggiato), Dotted (Punteggiato) o None (Nessuno).

BorderThickness: spessore del bordo di un controllo.

DelayItemLoading: ritarda il caricamento degli elementi (righe) fino a dopo il primo caricamento dello schermo.

DisplayMode: indica se il controllo consente l'input dell'utente (Edit), visualizza solo i dati (View) o è disabilitato (Disabled).

Fill: colore dello sfondo di un controllo.

Height: distanza tra i bordi superiore e inferiore del controllo.

ItemAccessibleLabel: etichetta di ogni elemento della raccolta per le utilità per la lettura dello schermo. Deve descrivere cosa è ogni elemento.

LoadingSpinner (None, Controls o Data) - Se None, la casella di selezione non viene visualizzata. Con Controlli | Dati, verrà visualizzata una casella di selezione quando si verifica un passaggio di rendering che risulta in righe vuote visibili.

LoadingSpinnerColor: il colore di riempimento del casella di selezione di caricamento. Il valore predefinito è impostato su BorderColor.

NavigationStep: distanza di scorrimento di una raccolta se la relativa proprietà ShowNavigation è impostata su true e l'utente seleziona una freccia di navigazione in una delle estremità della raccolta.

Selectable: indica se è possibile selezionare gli elementi della raccolta. Se impostato su true, le utilità per la lettura dello schermo identificano la raccolta come un elenco selezionabile. Quindi selezioni un elemento selezionandolo. Se impostato su false, le utilità per la lettura dello schermo identificano la raccolta come un normale elenco e la selezione di un elemento non viene eseguita.

ShowNavigation: indica se viene visualizzata una freccia in ciascuna estremità di una raccolta per permettere all'utente di scorrere tra i relativi elementi selezionando la freccia.

ShowScrollbar: indica se viene visualizzata una barra di scorrimento quando l'utente passa su una raccolta.

TemplateFill: colore dello sfondo di una raccolta.

TemplatePadding: distanza tra gli elementi in una raccolta.

TemplateSize: altezza del modello per una raccolta con orientamento verticale. In alternativa, la larghezza del modello per una raccolta con orientamento orizzontale. Le dimensioni minime sono uno.

Transition: effetto visivo (Pop, Push o None) quando l'utente posiziona il mouse su un elemento in una raccolta.

Visible: indica se un controllo viene visualizzato o è nascosto.

Width: distanza tra i bordi sinistro e destro di un controllo.

WrapCount : numero di elementi visualizzati per ogni riga o colonna in base al layout orizzontale o verticale.

X: distanza tra il bordo sinistro del controllo e il bordo sinistro del contenitore padre o della schermata.

Y: distanza tra il bordo superiore del controllo e il bordo superiore del contenitore padre o della schermata.

Filter( DataSource, Formula )

Reset( Control ): reimposta la raccolta allo stato iniziale. Lo stato iniziale include lo scorrimento fino al primo elemento e la selezione del primo elemento o l'impostazione predefinita, se presente.

Nota

Il controllo Reset non reimposta in modo ricorsivo tutti gli elementi figlio della raccolta.

Esempi

Visualizzare e filtrare i dati

Ottenere dati dall'utente

Linee guida per l'accessibilità

Contrasto dei colori

Se si fa clic in un punto qualsiasi di un elemento della raccolta, questo viene selezionato. È quindi necessario un contrasto dei colori adeguato tra:

  • BorderColor e il colore all'esterno della raccolta (se è presente un bordo).
  • Fill e il colore all'esterno della raccolta (se non è presente un bordo).

Supporto lettore schermo

  • AccessibleLabel deve essere presente.

    Nota

    Le utilità per la lettura dello schermo annunceranno la modifica degli elementi nella raccolta. Viene menzionata anche la proprietà AccessibleLabel. Questo fornisce il contesto per l'annuncio, aspetto importante quando sono presenti più raccolte nella stessa schermata.

  • Quando un elemento della raccolta contiene più controlli, utilizza ItemAccessibleLabel per mostrare il contenuto degli elementi della raccolta.

  • Imposta il valore di Selectable su true se desideri che gli utenti selezionino un elemento della raccolta. Altrimenti, imposta quel valore su false.

  • Quando un elemento della raccolta contiene più controlli, utilizza ItemAccessibleLabel per fornire un riepilogo del contenuto degli elementi della raccolta.

  • Selectable deve essere impostato in modo appropriato, a seconda che gli utenti debbano selezionare un elemento della raccolta.

Supporto per la tastiera

  • È consigliabile impostare ShowScrollbar su true. Nella maggior parte dei dispositivi touchscreen, la barra di scorrimento non verrà visualizzata fino all'inizio dello scorrimento.

  • Se si fa clic in un punto qualsiasi di un elemento della raccolta, questo viene selezionato. È quindi necessario che anche gli utenti della tastiera possano selezionare l'elemento della raccolta. Ad esempio, aggiungendo un controllo Pulsante con la relativa proprietà OnSelect impostata su Select(Parent).

    Nota

    I controlli all'esterno della raccolta non sono considerati nell'ordine di spostamento tramite tastiera all'interno della raccolta. Le proprietà TabIndex dei controlli all'interno di una raccolta hanno un ambito. Per altre informazioni, vedi Proprietà di accessibilità.

Vedi anche

Utilizzare DelayItemLoading e Loading spinner per migliorare le prestazioni nella Raccolta

Nota

Puoi indicarci le tue preferenze di lingua per la documentazione? Partecipa a un breve sondaggio. (il sondaggio è in inglese)

Il sondaggio richiederà circa sette minuti. Non viene raccolto alcun dato personale (Informativa sulla privacy).