Tilgjengelighetstips for Adaptive Cards

Copilot Studio-agenter fungerer bra med skjermlesere i Windows, for eksempel NonVisual Desktop Access (NVDA) og Jobbtilgang med Tale (JAWS). Hvis du vil optimalisere tilgjengeligheten, bør du vurdere disse tipsene.

Skjermlesere

Her er det viktigste for skjermleser og tilgjengelighet for tastaturnavigasjon for adaptive kort.

• Ta alltid med «etikett»-egenskapen: «Etikett»-egenskapen er det skjermlesere sier når en bruker fokuserer på inndata. Uten den kan det hende at skjermlesere bare sier «rediger felt» uten kontekst. Skjermlesere leser ofte ikke plassholdere, og de forsvinner når brukeren begynner å skrive. Unngå derfor å stole på dem for å hjelpe til med tilgjengelighet.

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

• Bruk "inputStyle" og "style" tankefullt: Unngå egendefinert stil som fjerner fokusindikatorer. Standard fokusring er hva tastaturbrukere er avhengige av for å vite hvor de er på kortet.

• Bruk "isRequired" og "errorMessage" for lesere: Selv for valgfrie felt hjelper en klar "errorMessage" skjermlesere med å kommunisere valideringstilbakemeldinger.

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

• Logisk tabulatorrekkefølge: Adaptive kort følger DOM-rekkefølgen (Document Object Model) for fanenavigasjon, så strukturer JSON-representasjonen av kortet i den rekkefølgen du vil at brukerne skal bla gjennom. Unngå å bruke «Kolonnesett»-oppsett som oppretter en visuelt logisk rekkefølge, men en forvirrende tabulatorrekkefølge for tastaturbrukere.

• Handlingsknapper er tilgjengelig som standard: Egenskaper som Action.Submit og Action.OpenUrl er opprinnelig fokuserbare. Kontroller at tittelen er beskrivende i stedet for noe vagt, for eksempel «Klikk her», fordi skjermlesere leser tittelen høyt.

• Legg til «type»: «TextBlock» for instruksjoner: Hvis en del av valgfrie felt trenger kontekst, angir du «type» som «TextBlock» før disse feltene. Skjermlesere leser felt i rekkefølge, noe som gir brukerne konteksten de trenger før de når inndataene.

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

• Unngå «isVisible»: «usann» for tilgjengelighetsscenarioer: Skjermlesere hopper over skjulte elementer helt. Hvis tilgjengelighet er prioriteten, må du holde valgfrie felt synlige. Hvis du må skjule dem, må du kontrollere at veksleknappen har en klar, beskrivende etikett.

• Pro tips for testing i Microsoft Teams: På grunn av små forskjeller i Microsoft Teams støtte for adaptive kort, anbefaler vi at du bruker den innebygde Windows Skjermleser eller NVDA til å validere fanerekkefølgen og at kunngjøringer fungerer som forventet.

Spesifikke skjemaegenskaper

Her er noen spesifikke egenskaper i Adaptive Cards-skjemaet som kan bidra til å forbedre tilgjengeligheten.

Etikettegenskapen

Etikettegenskapen er kritisk for skjermlesere. Ved å ha en tilkobling mellom etiketter og inndata, kan gjengivelsesbiblioteker angi de nødvendige egenskapene slik at brukere av hjelpeteknologier, for eksempel skjermlesere, kan samhandle riktig med inndata i adaptive kort.

Finn ut mer i Input.Text.

Hvorfor slår «etikett» «plassholder» for tilgjengelighet?

Vi anbefaler at du bruker «etikett»-egenskapen til å merke inndataparametere for adaptive kort, i stedet for «plassholder»-egenskapen. Det er en enkel og konsis måte å merke inndata for kortforfattere på.

Bruk av «TextBlock»-egenskaper som etiketter hindrer deg i å håndheve nærhet mellom inndata og etiketter. Ved å bruke «etikett»-egenskapen kan du sikre at begge de visuelle elementene gjengis ved siden av hverandre, noe som hjelper brukere som trenger skjermforstørrelsesprogram.

Finn ut mer i Inndatavalidering.

Bruk "errorMessage" for valideringstilbakemelding

ErrorMessage-egenskapen er tilgjengelig for alle inndatatyper for å angi meldingen som skal vises når en bruker angir en verdi som ikke er gyldig.

Finn ut mer i Inndatavalidering.

TextBlock med «stil»: «overskrift» for tilgjengelighetsstruktur

Bruk av «stil»: «overskrift» bruker standard overskriftsstil og markerer TextBlock-elementet som en overskrift for tilgjengelighet.

Finn ut mer i TextBlock-element.

Handlingsknapper – «verktøytips» for lydkommentarer

Handlingen Action.ToggleVisibility støtter en verktøytipsegenskap som definerer tekst som vises når brukeren holder musepekeren over handlingen. Lydkommentarprogramvare leser denne teksten.

Finn ut mer i Action.ToggleVisibility.

Forsiktig med «isVisible»: «false» for inputelementer

Hold inndataelementer synlige med validering. Inndataelementer med validering under Action.ToggleVisibility kan generere forvirring når skjulte inndataparametere ikke er gyldige.

Finn ut mer i Action.ToggleVisibility.

Egenskapen labelPosition for Input.ChoiceSet

For Input.ChoiceSet bestemmer labelPosition-egenskapen plasseringen til etiketten, enten linjebundet eller høyere (standard).

Finn ut mer i Input.ChoiceSet.