Στοιχείο ελέγχου "Συλλογή" στο Power Apps

Ένα στοιχείο ελέγχου που περιέχει άλλα στοιχεία ελέγχου και εμφανίζει ένα σύνολο δεδομένων.

Περιγραφή

Ένα στοιχείο ελέγχου Συλλογή μπορεί να εμφανίσει πολλές εγγραφές από μια προέλευση δεδομένων και κάθε εγγραφή μπορεί να περιέχει πολλούς τύπους δεδομένων. Για παράδειγμα, χρησιμοποιήστε ένα στοιχείο ελέγχου Συλλογή για να εμφανίσετε πολλές επαφές με κάθε στοιχείο που εμφανίζει στοιχεία επικοινωνίας που περιλαμβάνουν ένα όνομα, μια διεύθυνση και έναν αριθμό τηλεφώνου για κάθε επαφή.

Κάθε πεδίο δεδομένων εμφανίζεται σε ένα ξεχωριστό στοιχείο ελέγχου στο στοιχείο ελέγχου Συλλογή . Και μπορείτε να ρυθμίσετε αυτές τις παραμέτρους αυτών των στοιχείων ελέγχου στο πρότυπό του. Το πρότυπο εμφανίζεται ως το πρώτο στοιχείο μέσα στη συλλογή:

• Στο αριστερό άκρο ενός στοιχείου ελέγχου Συλλογή σε οριζόντιο προσανατολισμό.
• Και στο επάνω μέρος ενός στοιχείου ελέγχου Συλλογή σε κατακόρυφο προσανατολισμό.

Τυχόν αλλαγές που κάνετε στο πρότυπο αντικατοπτρίζονται στο στοιχείο ελέγχου Συλλογή .

Υπάρχουν διαθέσιμα προκαθορισμένα πρότυπα για την εμφάνιση εικόνων και κειμένου σε μια συλλογή καθώς και μια συλλογή για στοιχεία μεταβλητού ύψους.

Περιορισμοί

Το στοιχείο ελέγχου συλλογής έχει τους εξής περιορισμούς:

1. Εάν ένας χρήστης κάνει κύλιση στο στοιχείο ελέγχου συλλογής Ευέλικτο ύψος πριν από τη φόρτωση όλων των στοιχείων, το στοιχείο που είναι σε προβολή αυτή τη στιγμή μπορεί να μετακινηθεί προς τα κάτω και εκτός προβολής όταν ολοκληρωθεί η φόρτωση των δεδομένων. Για να αποφύγετε αυτό το πρόβλημα, χρησιμοποιήστε ένα τυπικό στοιχείο ελέγχου Συλλογή αντί για την παραλλαγή ευέλικτου ύψους .
2. Τα ακόλουθα στοιχεία ελέγχου δεν υποστηρίζονται μέσα σε μια συλλογή:
   • Φόρμα εμφάνισης
   • Φόρμα επεξεργασίας
   • Πρόγραμμα προβολής PDF
   • Πλακίδιο του Power BI
   • Πρόγραμμα επεξεργασίας εμπλουτισμένου κειμένου
   • Οθόνη με δυνατότητα κύλισης (Πλέγμα Fluid)
   • Σαρωτής γραμμικού κώδικα Web
3. Δεν μπορείτε να προσθέσετε μια συλλογή μέσα σε μια άλλη συλλογή εάν η δεύτερη βρίσκεται ήδη μέσα σε μια άλλη συλλογή. Το μέγιστο επίπεδο ένθεσης είναι 2.
4. Το ελάχιστο TemplateSize είναι ένα. Αυτό μπορεί να προκαλέσει τη μετακίνηση των στοιχείων ελέγχου στη Συλλογή από τις αναμενόμενες τιμές X ή Y , όταν δεν λαμβάνονται υπόψη το μέγεθος του προτύπου.
5. Εάν δημιουργήσετε αυτόματα μια εφαρμογή από δεδομένα, αποθηκεύστε την εφαρμογή και, στη συνέχεια, την ανοίξετε ξανά, η συλλογή αναζήτησης ενδέχεται να μην εμφανίσει αμέσως δεδομένα. Για να επιλύσετε αυτό το πρόβλημα, πληκτρολογήστε τουλάχιστον έναν χαρακτήρα στο πλαίσιο αναζήτησης και, στη συνέχεια, διαγράψτε το κείμενο που πληκτρολογήσατε. Στη συνέχεια, η συλλογή θα εμφανίσει τα δεδομένα όπως αναμένεται.
6. Εάν μια συλλογή περιλαμβάνει ένα στοιχείο ελέγχου Σύνθετο πλαίσιο, DatePicker, Slider ή Εναλλαγή με έναν OnChange κανόνα που επιδιορθώνει την ίδια προέλευση δεδομένων ή συλλογή με τη συλλογή, αυτό μπορεί να οδηγήσει σε μη αναμενόμενες ή μειωμένες επιδόσεις. Αυτό συμβαίνει επειδή ένας OnChange κανόνας που επιδιορθώνει την προέλευση δεδομένων της συλλογής μπορεί να δημιουργήσει έναν ατέρμονο κύκλο ενημέρωσης και επαναφόρτωσης. Για να αποφύγετε αυτό το ζήτημα, συνιστάται να μην χρησιμοποιείτε OnChange κανόνες όταν αυτά τα στοιχεία ελέγχου τοποθετούνται σε μια συλλογή.

Ιδιότητες κλειδιού

Default – Το στοιχείο ή εγγραφή από την προέλευση δεδομένων που θα επιλεγεί στη συλλογή κατά την εκκίνηση της εφαρμογής.

Στοιχεία – Η προέλευση των δεδομένων που εμφανίζονται σε ένα στοιχείο ελέγχου όπως συλλογή, λίστα ή γράφημα.

Selected – Το επιλεγμένο στοιχείο.

Πρόσθετες ιδιότητες

AccessibleLabel – Ετικέτα της συλλογής (όχι τα στοιχεία που περιέχει) για τα προγράμματα ανάγνωσης οθόνης. Θα πρέπει να περιγράφει τι είναι η λίστα των στοιχείων.

AllItems – Στοιχεία που φορτώνονται στη συλλογή. Αυτό μπορεί να είναι μικρότερο από τον πραγματικό αριθμό στοιχείων της προέλευσης δεδομένων. Όταν γίνεται κύλιση στη συλλογή, ενδέχεται να φορτωθούν περισσότερα στοιχεία. Το AllItems περιέχει επίσης στοιχεία ελέγχου που χρησιμοποιούνται σε κάθε στοιχείο συλλογής.

AllItemsCount - Πλήθος στοιχείων που φορτώνονται στη συλλογή. Αυτό μπορεί να είναι μικρότερο από τον πραγματικό αριθμό στοιχείων της προέλευσης δεδομένων. Όταν γίνεται κύλιση στη συλλογή, ενδέχεται να φορτωθούν περισσότερα στοιχεία.

BorderColor – Το χρώμα περιγράμματος ενός στοιχείου ελέγχου.

BorderStyle – Ορίζει εάν το περίγραμμα ενός στοιχείου ελέγχου είναι Συμπαγές, Διακεκομμένο, Διάστικτο ή Κανένα.

BorderThickness – Το πάχος του περιγράμματος ενός στοιχείου ελέγχου.

DelayItemLoading - Καθυστερήστε τη φόρτωση στοιχείων (γραμμές) μέχρι μετά την πρώτη φόρτωση της οθόνης.

DisplayMode – Ορίζει εάν το στοιχείο ελέγχου επιτρέπει την εισαγωγή δεδομένων από τον χρήστη (Επεξεργασία), εμφανίζει μόνο δεδομένα (Προβολή) ή είναι απενεργοποιημένο (Απενεργοποιημένο).

Fill – Το χρώμα φόντου ενός στοιχείου ελέγχου.

Height – Η απόσταση μεταξύ του επάνω και κάτω άκρου ενός στοιχείου ελέγχου.

ItemAccessibleLabel – Ετικέτα κάθε στοιχείου συλλογής για προγράμματα ανάγνωσης οθόνης. Θα πρέπει να περιγράφει τι είναι κάθε στοιχείο.

LoadingSpinner (None, Controls ή Data) - Όταν δεν υπάρχει, δεν θα εμφανίζεται το spinner. Στοιχεία ελέγχου πότε | Δεδομένα, το spinner θα εμφανίζεται όταν προκύπτει μια διαβίβαση απόδοσης που έχει ως αποτέλεσμα ορατές κενές γραμμές.

LoadingSpinnerColor - Το χρώμα γεμίσματος του στροφέα φόρτωσης. Η προεπιλογή ορίζεται σε BorderColor.

NavigationStep – Η διάρκεια κύλισης μιας συλλογής εάν η ιδιότητά της ShowNavigation έχει οριστεί σε true και ο χρήστης επιλέξει ένα βέλος περιήγησης σε οποιοδήποτε άκρο αυτής της συλλογής.

Selectable – Ορίζει εάν μπορούν να επιλεγούν στοιχεία συλλογής. Όταν οριστεί σε true, τα προγράμματα ανάγνωσης οθόνης προσδιορίζουν τη συλλογή ως λίστα με δυνατότητα επιλογής. Και μπορείτε να επιλέξετε ένα στοιχείο επιλέγοντάς το. Όταν οριστεί σε false, τα προγράμματα ανάγνωσης οθόνης προσδιορίζουν τη συλλογή ως κανονική λίστα και η επιλογή ενός στοιχείου δεν την επιλέγει.

ShowNavigation – Ορίζει εάν εμφανίζεται ένα βέλος σε κάθε άκρο μιας συλλογής, έτσι ώστε ένας χρήστης να μπορεί να κάνει κύλιση στα στοιχεία της συλλογής επιλέγοντας ένα βέλος.

ShowScrollbar – Ορίζει εάν εμφανίζεται μια γραμμή κύλισης όταν ο χρήστης μετακινεί τον δείκτη του ποντικιού πάνω σε μια συλλογή.

TemplateFill – Το χρώμα φόντου μιας συλλογής.

TemplatePadding – Η απόσταση μεταξύ στοιχείων σε μια συλλογή.

TemplateSize – Το ύψος του προτύπου για μια συλλογή σε κατακόρυφο προσανατολισμό. Ή το πλάτος του προτύπου για μια συλλογή σε οριζόντιο προσανατολισμό. Το ελάχιστο μέγεθος είναι ένα.

Transition – Το οπτικό εφέ (Αναδυόμενο, Προώθηση ή Κανένα) όταν ο χρήστης τοποθετεί τον δείκτη του ποντικιού πάνω σε ένα στοιχείο σε μια συλλογή.

Visible – Ορίζει εάν ένα στοιχείο ελέγχου εμφανίζεται ή είναι κρυφό.

Width – Η απόσταση μεταξύ του αριστερού και δεξιού άκρου ενός στοιχείου ελέγχου.

WrapCount – Ο αριθμός στοιχείων που εμφανίζονται ανά γραμμή ή στήλη βάσει οριζόντιας ή κατακόρυφης διάταξης.

X – Η απόσταση μεταξύ του αριστερού άκρου ενός στοιχείου ελέγχου και του αριστερού άκρου του γονικού του κοντέινερ ή της οθόνης.

Y – Η απόσταση μεταξύ του επάνω άκρου ενός στοιχείου ελέγχου και του επάνω άκρου του γονικού του κοντέινερ ή της οθόνης.

Σχετικές συναρτήσεις

Filter( DataSource, Formula )

Reset( Control ) - Επαναφέρει τη συλλογή σας στην αρχική της κατάσταση. Η αρχική κατάσταση περιλαμβάνει κύλιση στο πρώτο στοιχείο και επιλογή του πρώτου στοιχείου ή προεπιλογή, εάν υπάρχει.

Σημείωμα

Το στοιχείο ελέγχου επαναφοράς δεν επαναφέρει αναδρομικά όλα τα θυγατρικά στοιχεία της συλλογής.

Παραδείγματα

Εμφάνιση και φιλτράρισμα δεδομένων

• Εμφάνιση κειμένου
• Εμφάνιση εικόνων
• Φιλτράρισμα δεδομένων με επιλογή λίστας
• Φιλτράρισμα δεδομένων με προσαρμογή ρυθμιστικού

Λήψη δεδομένων από τον χρήστη

• Λήψη κειμένου
• Λήψη εικόνων
• Λήψη φωτογραφιών
• Λήψη ήχων
• Λήψη σχεδίων

Οδηγίες προσβασιμότητας

Αντίθεση χρωμάτων

Εάν το κλικ σε οποιοδήποτε σημείο ενός στοιχείου της συλλογής προορίζεται να το επιλέξει, πρέπει να υπάρχει επαρκής χρωματική αντίθεση ανάμεσα σε:

• BorderColor και το χρώμα εκτός της συλλογής (εάν υπάρχει περίγραμμα).
• Fill και το χρώμα εκτός της συλλογής (εάν δεν υπάρχει περίγραμμα).

Υποστήριξη ανάγνωσης οθόνης

• Πρέπει να υπάρχει AccessibleLabel.

  Σημείωμα

  Τα προγράμματα ανάγνωσης οθόνης θα ανακοινώνουν πότε αλλάζουν τα στοιχεία στη συλλογή. Η AccessibleLabel επίσης αναφέρεται. Αυτό παρέχει το περιβάλλον για την ανακοίνωση και είναι ακόμα πιο σημαντικό όταν υπάρχουν πολλές συλλογές στην ίδια οθόνη.

• Όταν ένα στοιχείο συλλογής περιέχει πολλά στοιχεία ελέγχου, χρησιμοποιήστε τη itemAccessibleLabel για να εμφανίσετε τα περιεχόμενα των στοιχείων συλλογής.

• Ορίστε την τιμή selectable σε true εάν θέλετε οι χρήστες να επιλέξουν ένα στοιχείο συλλογής. Διαφορετικά, ορίστε αυτή την τιμή σε false.

• Όταν ένα στοιχείο συλλογής περιέχει πολλά στοιχεία ελέγχου, χρησιμοποιήστε την ItemAccessibleLabel για να παρέχετε μια σύνοψη των περιεχομένων του στοιχείου συλλογής.

• Με δυνατότητα επιλογής θα πρέπει να οριστεί κατάλληλα, ανάλογα με το αν οι χρήστες προορίζονται για την επιλογή ενός στοιχείου συλλογής.

Υποστήριξη πληκτρολογίου

• Εξετάστε το ενδεχόμενο να ορίσετε τη ShowScrollbar σε true. Στις περισσότερες συσκευές με οθόνη αφής, η γραμμή κύλισης δεν θα εμφανίζεται μέχρι να ξεκινήσει η κύλιση.

• Εάν το κλικ σε οποιοδήποτε σημείο ενός στοιχείου της συλλογής προορίζεται να το επιλέξει, πρέπει επίσης να υπάρχει τρόπος για τους χρήστες πληκτρολογίου να επιλέξουν το στοιχείο συλλογής. Για παράδειγμα, προσθέτοντας ένα Κουμπί στο οποίο η ιδιότητά του OnSelect έχει οριστεί σε Select(Parent)..

  Σημείωμα

  Τα στοιχεία ελέγχου εκτός της συλλογής δεν λαμβάνονται υπόψη στη σειρά περιήγησης με το πληκτρολόγιο εντός της συλλογής. Η εμβέλεια των στοιχείων ελέγχου TabIndex μέσα σε μια συλλογή. Ανατρέξτε στο θέμα Ιδιότητες προσβασιμότητας για να μάθετε περισσότερα.

Δείτε επίσης

Χρήση delayItemLoading και loading spinner για τη βελτίωση των επιδόσεων στη Συλλογή