Facepile έλεγχος (έκδοση προεπισκόπησης)

[Αυτό το άρθρο αποτελεί τεκμηρίωση προέκδοσης και ενδέχεται να αλλάξει.]

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

Σημείωμα

Βρέθηκε πλήρης τεκμηρίωση και πηγαίος κώδικας στο αρχείο φύλαξης στοιχείων κωδικών GitHub.

Σημαντικό

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

Description

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

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

Ιδιότητες

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

Ιδιότητα	Description
Items	Τα στοιχεία ενέργειας προς απόδοση. Το πρώτο στοιχείο θεωρείται το ριζικό στοιχείο.
PersonaSize	Μέγεθος της εικονικής προσωπικότητας που θα εμφανίζεται στην οθόνη
OverflowButtonType	Για να επιλέξετε τον τύπο του κουμπιού Υπερχείλισης που θα εμφανίζεται και εάν θα εμφανίζεται ή όχι
MaxDisplayablePersonas	Μέγιστος αριθμός εικονικής προσωπικότητας για εμφάνιση του Facepile Το πέντε είναι ο προεπιλεγμένος και συνιστώμενος αριθμός
ImageShouldFadeIn	Μπορείτε να προσδιορίσετε εάν η εικόνα θα πρέπει να έχει αποτέλεσμα Fade κατά την εμφάνιση της
ShowAddButton	Εάν το κουμπί Προσθήκη θα πρέπει να εμφανίζεται στο στοιχείο Facepile
OverflowButtonLabel	Ετικέτα Aria για το κουμπί Υπερχείλιση
AddbuttonAriaLabel	Ετικέτα Aria για το κουμπί Προσθήκη

Items Καταλύματα

'Ονομα	Description
ItemPersonaName	Εμφανιζόμενο όνομα της εικονικής προσωπικότητας
ItemPersonaKey	Το κλειδί προσδιορίζει το συγκεκριμένο στοιχείο Τα κλειδί πρέπει να είναι μοναδικό
ItemPersonaImage	Η στήλη εικόνας του πίνακα Dataverse που περιέχει την εικόνα εικονικής προσωπικότητας (Εικόνα προφίλ)
ItemPersonaImageInfo	Περιεχόμενο διεύθυνσης Url ή Base64 της εικόνας εικονικής προσωπικότητας (Εικόνα προφίλ)
ItemPersonaPresence	Προαιρετικό - Για καθορισμό της παρουσίας της εικονικής προσωπικότητας
IsImage	Εάν η εικόνα εικονικής προσωπικότητας(ItemPersonaImage) είναι μια στήλη εικόνας του πίνακα Dataverse. Αυτή η ιδιότητα επιτρέπει στο στοιχείο να αποδώσει την εικόνα βάσει του τύπου (διεύθυνση Url ή εικόνα). Αληθές σε περίπτωση που η εικόνα πρέπει να αναφέρεται από τον πίνακα Dataverse και ψευδής περίπτωση που πρόκειται για διεύθυνση URL ή Base64 για αναφορά από την ιδιότητα ItemPersonaImageInfo
ItemPersonaClickable	Εάν η εικονική προσωπικότητα πρέπει να μπορεί να πατηθεί ή όχι

Παράδειγμα τύπου Power Fx για Items (χρησιμοποιεί τη σύνδεση Χρήστες του Office 365)

Δημιουργία συλλογής Items με φωτογραφίες χρησιμοποιώντας τη σύνδεση Χρήστες του Office 365

Μια λίστα χρηστών μπορεί να προέρχεται από οποιοδήποτε προέλευση δεδομένων, αλλά η εικόνα πρέπει να παρέχεται στο στοιχείο. Εάν η προέλευση δεδομένων δεν έχει εικόνες για τους χρήστες, μπορείτε να χρησιμοποιήσετε τη συνάρτηση AddColumns() Power Fx για να προσθέσετε τα σωστά χαρακτηριστικά στη λίστα και να ανακτήσετε την εικόνα του χρήστη, από μια λίστα με αναγνωριστικά χρήστη ή κύρια ονόματα χρήστη που αντιστοιχίζονται σε έναν ενεργό χρήστη στο Microsoft Entra.

Δημιουργήστε μια συλλογή που ονομάζεται UserPersonas χρησιμοποιώντας τη Σύνδεση Χρηστών του Office 365, με αναφορά στο παρακάτω δείγμα κώδικα και, στη συνέχεια, μεταβιβάστε τη συλλογή στην ιδιότητα Items του στοιχείου ελέγχου.

ClearCollect(
    UserPersonas,
    AddColumns(
       // Get first 10 users who have email ID - optional
        Filter(
            Office365Users.SearchUser({top: 10}),
            Mail <> Blank()
        ),
        "ItemPersonaKey",
        Mail,
        "ItemPersonaName",
        DisplayName,
        "IsImage",
        false,
        "ItemPersonaImageInfo",
        //Get base64 image data
        Substitute(
            JSON(
                Office365Users.UserPhotoV2(Id),
                JSONFormat.IncludeBinaryData
            ),
            """",
            ""
        ),
        "ItemPersonaPresence",
        "Away",
        "ItemPersonaClickable",
        true
    )
);

Σημείωμα

Το πεδίο IsImage έχει οριστεί σε false επειδή το πεδίο ItemPersonaImageInfo προέρχεται από μια διεύθυνση URL εικόνας. Για να αποδώσετε πεδία εικόνας Dataverse, ορίστε το πεδίο IsImage σε true και χρησιμοποιήστε το ItemPersonaImage για να το μεταβιβάσετε την τιμή της εικόνας.

Χρήση

Ιδιότητες ύφους

Ιδιότητα	Description
Theme	Αποδέχεται μια συμβολοσειρά JSON που δημιουργείται με τη χρήση της Σχεδίασης θέματος περιβάλλοντος εργασίας χρήστη Fluent (windows.net). Αν αφήσετε αυτό το κενό, θα χρησιμοποιηθεί το προεπιλεγμένο θέμα που ορίζεται από το Power Apps. Αν αφήσετε αυτό το κενό, θα χρησιμοποιηθεί το προεπιλεγμένο θέμα που ορίζεται από το Power Apps. Δείτε θέματα για οδηγία για τον τρόπο ρύθμισης παραμέτρων.
AccessibilityLabel	Ετικέτα aria προγράμματος ανάγνωσης οθόνης

Ιδιότητες συμβάντος

Ιδιότητα	Description
InputEvent	Ένα συμβάν για αποστολή στο στοιχείο ελέγχου. Για παράδειγμα, SetFocus.

Συμπεριφορά

Υποστηρίζει το SetFocus ως InputEvent.

Ρύθμιση παραμέτρων συμπεριφοράς On Select

Χρησιμοποιήστε τον τύπο Switch() στην ιδιότητα του στοιχείου OnSelect για να ρυθμίσετε συγκεκριμένες ενέργειες για κάθε στοιχείο, αναφερόμενος στο επιλεγμένο ItemPersonaKey του στοιχείου ελέγχου ως η τιμή εναλλαγής.

Παράδειγμα τύπου Power Fx σε ιδιότητα OnSelect του Facepile.

  Switch( Self.EventName,
    /* Define action when persona clicked */
    "PersonaEvent", 
    Notify("Persona clicked: " & Self.Selected.ItemPersonaKey);
    ,
    
    /* Define logic when the add button clicked */
    "AddButtonEvent", 
    Notify("Add button was clicked");
    ,
  
    /* Define logic when overflow button clicked*/
    "OverFlowButtonEvent",
    Notify("Overflow button clicked");
  )

Περιορισμοί

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