Ιδιότητες στοιχείου καμβά (πειραματικές)

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

Σημαντικό

• Πρόκειται για μια πειραματική δυνατότητα.
• Οι πειραματικές δυνατότητες δεν προορίζονται για χρήση παραγωγής και ενδέχεται να έχουν περιορισμένη λειτουργικότητα. Αυτές οι δυνατότητες είναι διαθέσιμες πριν από μια επίσημη κυκλοφορία έτσι ώστε οι πελάτες να έχουν πρόσβαση από νωρίς και να κάνουν σχόλια. Περισσότερες πληροφορίες: Πειραματικές δυνατότητες και δυνατότητες προεπισκόπησης
• Η συμπεριφορά που περιγράφει αυτό το άρθρο είναι διαθέσιμη μόνο όταν η πειραματική δυνατότητα βελτιωμένων ιδιοτήτων στοιχείων στις Ρυθμίσεις > Επερχόμενες δυνατότητες > Πειραματική είναι ενεργοποιημένη (απενεργοποιημένη από προεπιλογή).
• Τα σχόλιά σας είναι πολύτιμα για εμάς. Πείτε μας τη γνώμη σας στο φόρουμ της κοινότητας πειραματικών δυνατοτήτων του Power Apps.

Τύποι ιδιοτήτων

Υπάρχουν τέσσερις τύποι ιδιοτήτων οι οποίοι είναι διαθέσιμοι στους δημιουργούς:

1. Ιδιότητες δεδομένων: Οι ιδιότητες δεδομένων αφορούν δεδομένα, όπως μια τιμή χρώματος ή κειμένου. Η ιδιότητα δεδομένων μπορεί να οριστεί ως είσοδος ή έξοδος, γεγονός που υποδεικνύει αν το στοιχείο παρέχει δεδομένα στην εφαρμογή (έξοδος) ή αν η εφαρμογή παρέχει δεδομένα στο στοιχείο (είσοδος). Οι ιδιότητες δεδομένων είναι οι μόνες ιδιότητες που συμμετέχουν στη ροή δεδομένων εφαρμογής.
2. Ιδιότητες συνάρτησης: Οι ιδιότητες των συναρτήσεων σχετίζονται με τη λογική, όπως η εκτέλεση ενός υπολογισμού με βάση συγκεκριμένες παραμέτρους ή η αλλαγή κειμένου. Η ιδιότητα συνάρτησης μπορεί να οριστεί ως είσοδος ή έξοδος, γεγονός που υποδεικνύει αν το στοιχείο παρέχει μια συνάρτηση στην εφαρμογή (έξοδος) ή αν η εφαρμογή παρέχει συνάρτηση στο στοιχείο (είσοδος). Οι ιδιότητες συναρτήσεων δεν συμμετέχουν στη ροή δεδομένων μιας εφαρμογής και δεν μπορούν να χρησιμοποιήσουν μεταβλητές στοιχείου ή εφαρμογής.
3. Ιδιότητες ενεργειών: Οι ιδιότητες ενέργειας είναι ένας τύπος ιδιότητας που ασχολείται με τη λογική και συμπεριφέρεται όπως μια συνάρτηση εξόδου. Κατά συνέπεια, το στοιχείο έχει τη λογική που ορίζεται και αυτή η λογική μπορεί να χρησιμοποιήσει παραστάσεις που έχουν χρησιμοποιηθεί και να διαχειριστεί συλλογές ή μεταβλητές ("συμπεριφορά"). Για παράδειγμα, μια ιδιότητα Clear() ενέργειας θα μπορούσε να παρέχει λειτουργικότητα που μπορεί να καλέσει η εφαρμογή για να διαγράψει κάποιες τιμές στο στοιχείο, ή μια ιδιότητα Save() ενέργειας που ενημερώνει μια προέλευση δεδομένων.
4. Ιδιότητες συμβάντος: Οι ιδιότητες συμβάντος είναι μια κατηγορία ιδιότητας που περιλαμβάνει λογική και συναρτήσεις ως συνάρτηση εισόδου. Έτσι, η εφαρμογή ορίζει τη λογική, την οποία μπορεί να καλέσει το στοιχείο και αυτή η λογική μπορεί να χρησιμοποιεί αλυσιδωτές εκφράσεις και να χειρίζεται συλλογές ή μεταβλητές ("συμπεριφορά"). Κατά κανόνα, τα ονόματα αυτών των ιδιοτήτων απεικονίζουν ένα συμβάν, όπως τα OnSelect ή OnChanged.

Ιδιότητα δεδομένων

Μπορείτε να φανταστείτε εύκολα τη χρήση μιας ιδιότητας δεδομένων. Τα τυπικά στοιχεία ελέγχου σε εφαρμογές έχουν συνήθως διάφορες ιδιότητες δεδομένων, για να ορίσετε προεπιλεγμένες τιμές, χρώμα κειμένου, μέγεθος κλπ. Ας δούμε ένα απλό παράδειγμα όπου θέλουμε οι ιδιότητες ενός στοιχείου ελέγχου να είναι διαθέσιμες στην εφαρμογή φιλοξενίας. Σε αυτό το παράδειγμα, το στοιχείο μας ονομάζεται Component1. Θα βάζουμε ένα στοιχείο ελέγχου ρυθμιστικού μέσα στο στοιχείο μας. Θα έχουμε μια ιδιότητα Εισόδου για να καθορίσουμε το χρώμα από την εφαρμογή που καταναλώνει και μια ιδιότητα Εξόδου όπου το στοιχείο μπορεί να πει στην εφαρμογή ποια είναι η τρέχουσα τιμή του ρυθμιστικού. Στο παρακάτω παράδειγμα θεωρείται ότι το στοιχείο σας περιέχει ένα στοιχείο ελέγχου Ρυθμιστικού με όνομα Slider.

1. Στο τμήμα παραθύρου ιδιοτήτων του στοιχείου, επιλέξτε Νέα προσαρμοσμένη ιδιότητα.
2. Στο τμήμα παραθύρου Νέα προσαρμοσμένη ιδιότητα, πληκτρολογήστε το εμφανιζόμενο όνομα Slider Color.
3. Επιλέξτε τον τύπο ιδιότητας των δεδομένων και επιλέξτε την τιμή εισόδου ορισμός ιδιότητας.
4. Τελικά, από την αναπτυσσόμενη λίστα Τύπος δεδομένων, επιλέξτε Χρώμα.
5. Επιλέξτε Δημιουργία.

Στη συνέχεια, επιλέξτε το στοιχείο ελέγχου Slider1 Ρυθμιστικό. Βρείτε την ιδιότητα ValueFill και στη γραμμή τύπων, καταχωρήστε Component1.SliderColor. Ο όρος Component1 αναφέρεται στο όνομα του στοιχείου μας και ο όρος SliderColor είναι το όνομα της ιδιότητας που προσθέσαμε προηγουμένως.

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

Επίσης, θα θέλαμε να δώσουμε την τιμή του ρυθμιστικού στην εφαρμογή που καταναλώνει. Για να το επιτύχετε αυτό, θα προσθέσουμε μια ιδιότητα Εξόδου .

1. Στο τμήμα παραθύρου ιδιοτήτων του στοιχείου, επιλέξτε Νέα προσαρμοσμένη ιδιότητα.
2. Στο τμήμα παραθύρου Νέα προσαρμοσμένη ιδιότητα, πληκτρολογήστε το εμφανιζόμενο όνομα Slider Value.
3. Επιλέξτε τον τύπο ιδιότητας των δεδομένων και επιλέξτε την τιμή εξόδου ορισμός ιδιότητας.
4. Τελικά, από την αναπτυσσόμενη λίστα Τύπος δεδομένων, επιλέξτε Αριθμός.
5. Επιλέξτε Δημιουργία.

Όταν μια ιδιότητα δεδομένων ορίζεται ως έξοδος, το στοιχείο παρέχει την τιμή στην εφαρμογή που καταναλώνει. Για να ορίσετε τον τύπο για αυτό, θα πρέπει να ορίστε τη νέα ιδιότητα SliderValue του στοιχείου στην ιδιότητα Τιμή του ρυθμιστικού.

1. Στο τμήμα παραθύρου ιδιοτήτων του στοιχείου, κάντε κλικ στην ιδιότητα Slider Value.
2. Στη γραμμή τύπων, αντικαταστήστε την προεπιλεγμένη τιμή 100 με τον ακόλουθο τύπο: Slider1.Value.

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

Ιδιότητα συνάρτησης

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

Σημείωση

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

Μια συνάρτηση Εξόδου είναι ένας απλός τρόπος για να δημιουργήσετε μια προσαρμοσμένη συνάρτηση για το Power Apps. Το στοιχείο καθορίζει μια συνάρτηση εξόδου με μια παράσταση που παίρνει ορισμένα ορίσματα και επιστρέφει μια τιμή. Αυτή η συνάρτηση μπορεί να χρησιμοποιηθεί σε μια εφαρμογή χρησιμοποιώντας το όνομα του στοιχείου (π.χ. Component1) με κλήση του Component1.MyFunction(arg1, arg2).

Μια συνάρτηση Εισόδου είναι ένας τρόπος με τον οποίο μια εφαρμογή που καταναλώνει για την παροχή λογικής σε ένα στοιχείο, παρόμοιο με ένα δείκτη συνάρτησης ή μια συνάρτηση επιστροφής κλήσης. Για παράδειγμα, το στοιχείο σας μπορεί να ασχολείται με τα ονόματα των ανθρώπων και να έχει μια συνάρτηση εισόδου με ορίσματα firstname και lastname και να αναμένει μια συμβολοσειρά πίσω. Η εφαρμογή θα μπορούσε να ορίσει την παράσταση συνάρτησης προς επιστροφή $"{firstname} {lastname}" ή θα μπορούσε να επιλέξει να ορίσει μια παράσταση για $"{lastname}, {firstname}". Το στοιχείο μπορεί απλώς να καλέσει τη συνάρτηση που παρέχει ο δημιουργός της εφαρμογής και να χρησιμοποιήσει τη συμβολοσειρά που έχει επιστραφεί.

Ιδιότητα ενέργειας

Οι ιδιότητες της ενέργειας είναι παρόμοιες με τις ιδιότητες συνάρτησης του τύπου Έξοδος, αλλά επιτρέπουν τύπους πλευρικής επίδρασης και σύνδεση σε αλυσίδα παράστασης. Ένα στοιχείο θα μπορούσε να έχει μια ιδιότητα ενέργειας AddRecord που να επιτρέπει στην εφαρμογή να προσθέσει μια καρτέλα σε μια συλλογή μέσα στο στοιχείο, ή μια ενέργεια Reset που διαγράφει μεταβλητές ή συλλογές μέσα στο στοιχείο.

Στο παράδειγμα των παραδειγμάτων του ρυθμιστικού που χρησιμοποιήθηκαν για την ιδιότητα δεδομένων νωρίτερα, μπορούμε να εισαγάγουμε μια ιδιότητα ενέργειας που καλείται ResetValue να επαναφέρει το ρυθμιστικό στην προεπιλεγμένη τιμή του. Μπορούμε να χρησιμοποιήσουμε τον τύπο Reset( Slider1 ) για αυτό. Τώρα, οι παρουσίες του στοιχείου μας στην εφαρμογή μπορούν να καλούν το Component1.ResetValue() για να ρυθμίσουν το ρυθμιστικό ξανά στην προεπιλεγμένη τιμή.

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

Υπάρχουν πολλές συνήθεις ιδιότητες τύπων συμβάντος, ουσιαστικά ιδιότητες συναρτήσεων συμπεριφοράς εισόδου, στα τυπικά στοιχεία ελέγχου. Το πιο ενδεικτικό παράδειγμα είναι η επιλογή OnSelect στο στοιχείο ελέγχου του κουμπιού. Ένα στοιχείο θα μπορούσε να ορίσει οποιονδήποτε αριθμό ιδιοτήτων συμβάντος και να καλέσει αυτά τα συμβάντα όπως μια συνάρτηση. Για παράδειγμα, ένα στοιχείο που διαθέτει στοιχείο ελέγχου κουμπιού θα μπορούσε να έχει μια ιδιότητα συμβάντος με το όνομα OnButtonClicked. Στο στοιχείο ελέγχου κουμπιού onSelect το στοιχείο μπορεί να κάνει κλήση στην ιδιότητα Component1.OnButtonClicked(). Μια εφαρμογή που καταναλώνει μπορεί με τον τρόπο αυτό να ορίσει τη δική της συνάρτηση για αυτήν την ιδιότητα, ώστε να ενεργεί όταν πατήσει το κουμπί μέσα στο στοιχείο.

Προεπιλεγμένες τιμές για ιδιότητες ή ορίσματα

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

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