Συμβουλές προσβασιμότητας για προσαρμόσιμες κάρτες

Οι πράκτορες του Copilot Studio συνεργάζονται καλά με προγράμματα ανάγνωσης οθόνης στα Windows, όπως η Μη Εξουσιοδοτημένη πρόσβαση επιφάνειας εργασίας (NVDA) και η Πρόσβαση στην εργασία με ομιλία (JAWS). Για να βελτιστοποιήσετε την προσβασιμότητα, εξετάστε αυτές τις συμβουλές.

Προγράμματα ανάγνωσης οθόνης

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

• Να συμπεριλάβετε πάντα την ιδιότητα "label": Η ιδιότητα "label" είναι αυτή που ανακοινώνουν τα προγράμματα ανάγνωσης οθόνης όταν ένας χρήστης εστιάζει σε μια είσοδο. Χωρίς αυτό, τα προγράμματα ανάγνωσης οθόνης μπορεί απλώς να λένε "επεξεργασία πεδίου" χωρίς συμφραζόμενα. Τα προγράμματα ανάγνωσης οθόνης συχνά δεν διαβάζουν σύμβολα κράτησης θέσης και εξαφανίζονται όταν ο χρήστης αρχίσει να πληκτρολογεί. Επομένως, αποφύγετε να βασίζεστε σε αυτές για να σας βοηθήσουν με την προσβασιμότητα.

  {
    "type": "Input.Text",
    "id": "middleName",
    "label": "Middle name (optional)",
    "placeholder": "Enter your middle name"
  }
  

• Χρησιμοποιήστε προσεκτικά τα στοιχεία "inputStyle" και "style": Αποφύγετε το προσαρμοσμένο στυλ που καταργεί τις ενδείξεις εστίασης. Το προεπιλεγμένο δαχτυλίδι εστίασης είναι αυτό στο οποίο βασίζονται οι χρήστες πληκτρολογίου για να γνωρίζουν πού βρίσκονται στην κάρτα.

• Χρησιμοποιήστε τα "isRequired" και "errorMessage" για τους αναγνώστες: Ακόμη και για τα προαιρετικά πεδία, ένα σαφές "σφάλμαMessage" βοηθά τα προγράμματα ανάγνωσης οθόνης να επικοινωνήσουν σχόλια επικύρωσης.

  {
    "type": "Input.Text",
    "id": "middleName",
    "label": "Middle name (optional)",
    "isRequired": false,
    "errorMessage": "Please enter a valid middle name"
  }
  

• Λογική σειρά καρτελών: Οι προσαρμόσιμες κάρτες ακολουθούν τη σειρά μοντέλου αντικειμένου εγγράφου (DOM) για περιήγηση στην καρτέλα, επομένως, δομήστε την αναπαράσταση JSON της κάρτας σας με τη σειρά που θέλετε οι χρήστες να κάνουν tab. Αποφύγετε τη χρήση διατάξεων "ColumnSet" που δημιουργούν μια οπτικά λογική σειρά, αλλά μια πολύπλοκη σειρά καρτελών για τους χρήστες πληκτρολογίου.

• Τα κουμπιά ενεργειών είναι προσβάσιμα από προεπιλογή με το πληκτρολόγιο: Ιδιότητες όπως "Action.Submit" και "Action.OpenUrl" είναι εγγενώς εστιασμένες. Βεβαιωθείτε ότι ο τίτλος σας είναι περιγραφικός και όχι κάτι αόριστο όπως "Κάντε κλικ εδώ" επειδή τα προγράμματα ανάγνωσης οθόνης διαβάζουν δυνατά τον τίτλο.

• Προσθέστε "type": "TextBlock" για οδηγίες: Εάν μια ενότητα προαιρετικών πεδίων χρειάζεται περιβάλλον, ορίστε το "type" ως "TextBlock" πριν από αυτά τα πεδία. Τα προγράμματα ανάγνωσης οθόνης διαβάζουν πεδία με τη σειρά, παρέχοντας στους χρήστες το περιβάλλον που χρειάζονται πριν φτάσουν στις εισόδους.

  {
    "type": "TextBlock",
    "text": "The following fields are optional. You can skip them if not applicable.",
    "wrap": true
  }
  

• Αποφύγετε το "isVisible": "false" για σενάρια προσβασιμότητας: Οι αναγνώστες οθόνης παραλείπουν εντελώς τα κρυφά στοιχεία. Εάν η προσβασιμότητα είναι η προτεραιότητα, διατηρήστε τα προαιρετικά πεδία ορατά. Εάν πρέπει να τις αποκρύψετε, βεβαιωθείτε ότι το κουμπί εναλλαγής έχει μια σαφή, περιγραφική ετικέτα.

• Συμβουλή pro για τις δοκιμές στο Microsoft Teams: Λόγω ελαφρών διαφορών στην υποστήριξη του Microsoft Teams για προσαρμόσιμες κάρτες, συνιστούμε να χρησιμοποιήσετε τον ενσωματωμένο Αφηγητή Windows ή το NVDA για να επικυρώσετε τη σειρά tab και ότι οι ανακοινώσεις λειτουργούν όπως αναμένεται.

Συγκεκριμένες ιδιότητες σχήματος

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

Η ιδιότητα "label"

Η ιδιότητα "label" είναι κρίσιμη για τα προγράμματα ανάγνωσης οθόνης. Με μια σύνδεση μεταξύ ετικετών και εισόδων, οι βιβλιοθήκες απόδοσης μπορούν να ορίσουν τις απαραίτητες ιδιότητες για να επιτρέπουν στους χρήστες τεχνολογιών υποβοήθησης, όπως τα προγράμματα ανάγνωσης οθόνης, να αλληλεπιδρούν σωστά με τις εισόδους μέσα σε προσαρμόσιμες κάρτες.

Μάθετε περισσότερα στο στοιχείο Input.Text.

Γιατί η λέξη "ετικέτα" νικά το "σύμβολο κράτησης θέσης" για προσβασιμότητα;

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

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

Μάθετε περισσότερα στην ενότητα Επικύρωση εισόδου.

Χρήση της επιλογής "errorMessage" για σχόλια επικύρωσης

Η ιδιότητα "errorMessage" είναι διαθέσιμη για όλους τους τύπους εισόδου, προκειμένου να καθοριστεί το μήνυμα που θα εμφανίζεται όταν ένας χρήστης εισαγάγει μια τιμή που δεν είναι έγκυρη.

Μάθετε περισσότερα στην ενότητα Επικύρωση εισόδου.

TextBlock με "style": "heading" για δομή προσβασιμότητας

Η χρήση του "στυλ": "heading" εφαρμόζει το προεπιλεγμένο στυλ επικεφαλίδας και επισημαίνει το στοιχείο TextBlock ως επικεφαλίδα για προσβασιμότητα.

Μάθετε περισσότερα στο στοιχείο TextBlock.

Κουμπιά ενεργειών— "συμβουλή εργαλείου" για αφήγηση

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

Μάθετε περισσότερα στο στοιχείο Action.ToggleVisibility.

Προσοχή με το "isVisible": "false" για στοιχεία εισόδου

Διατηρήστε τα στοιχεία εισόδου ορατά με επικύρωση. Τα στοιχεία εισόδου με επικύρωση στην περιοχή "Action.ToggleVisibility" μπορεί να δημιουργήσουν σύγχυση όταν οι παράμετροι κρυφής εισόδου δεν είναι έγκυρες.

Μάθετε περισσότερα στο στοιχείο Action.ToggleVisibility.

Η ιδιότητα "labelPosition" για input.ChoiceSet

Για την "Input.ChoiceSet", η ιδιότητα "labelPosition" προσδιορίζει τη θέση της ετικέτας, ενσωματωμένη ή επάνω από (προεπιλογή).

Μάθετε περισσότερα στο Input.ChoiceSet.