Tilgængelighedstip til adaptive kort

Copilot Studio-agenter fungerer godt med skærmlæsere på Windows, såsom NonVisual Desktop Access (NVDA) og Job Access with Speech (JAWS). For at optimere tilgængeligheden, overvej disse tips.

Skærmlæsere

Når det gælder tilgængelighed for skærmlæsere og tastaturnavigation i Adaptive kort, er dette det vigtigste.

  • Sørg for altid at inkludere "label"-egenskaben: "label"-egenskaben er det, skærmlæsere læser op, når en bruger fokuserer på et input. Uden det kan skærmlæsere bare sige "rediger felt" uden kontekst. Skærmlæsere læser ofte ikke pladsholdere, og de forsvinder, når brugeren begynder at skrive. Undgå derfor at bruge dem til at sikre tilgængelighed.

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

  • Brug "inputStyle" og "style" med omtanke: Undgå brugerdefineret styling, der fjerner fokusindikatorer. Tastaturbrugere er afhængige af standardfokusringen for at vide, hvor de befinder sig på kortet.

  • Brug "isRequired" og "errorMessage" for skærmlæsere: Selv for valgfrie felter hjælper en tydelig "errorMessage" skærmlæsere med at formidle valideringsfeedback.

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

  • Logisk fanerækkefølge: Adaptive kort følger Document Object Model (DOM)-rækkefølgen for fanenavigation, så strukturér JSON-repræsentationen af dit kort i den rækkefølge, du ønsker, at brugerne skal navigere igennem. Undgå at bruge "ColumnSet"-layouts, der skaber en visuelt logisk rækkefølge, men en forvirrende fanerækkefølge for tastaturbrugere.

  • Handlingsknapper er som standard tastaturtilgængelige: Egenskaber som "Action.Submit" og "Action.OpenUrl" er naturligt fokuserbare. Sørg for, at din titel er beskrivende og ikke noget vagt som "Klik her", fordi skærmlæsere læser titlen højt.

  • Tilføj "type": "TextBlock" for instruktioner: Hvis en sektion af valgfrie felter har brug for kontekst, angiv "type" som "TextBlock" før disse felter. Skærmlæsere læser felter i rækkefølge og giver brugerne den kontekst, de har brug for, før de når til inputfelterne.

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

  • Undgå "isVisible": "false" i tilgængelighedsscenarier: Skærmlæsere springer skjulte elementer helt over. Hvis tilgængelighed er prioriteten, hold valgfrie felter synlige. Hvis du er nødt til at skjule dem, så sørg for, at skifteknappen har en klar og beskrivende etiket.

  • Tip til test i Microsoft Teams: På grund af små forskelle i understøttelsen af Adaptive kort i Microsoft Teams anbefaler vi, at du bruger den indbyggede Windows Oplæser eller NVDA til at validere tabulatorrækkefølgen og sikre, at annonceringer fungerer som forventet.

Specifikke skemaegenskaber

Her er nogle specifikke egenskaber i Adaptive kort-skemaet, der kan hjælpe med at forbedre tilgængelighed.

"Label"-egenskaben

"Label"-egenskaben er afgørende for skærmlæsere. Ved at have en forbindelse mellem labels og input kan gengivelsesbiblioteker sætte de nødvendige egenskaber, så brugere af hjælpemidler, såsom skærmlæsere, kan interagere korrekt med inputfelter i Adaptive kort.

Læs mere i Input.Text.

Hvorfor er "label" bedre end "placeholder" for tilgængelighed?

Vi anbefaler at bruge "label" til tagging af inputparametre i Adaptive kort i stedet for egenskaben "placeholder". Det er en enkel og kortfattet måde at navngive input for kortforfattere.

Hvis du bruger "TextBlock"-egenskaber som labels, kan du ikke sikre, at input og labels placeres tæt på hinanden. Ved at bruge "label"-egenskaben kan du sikre, at begge visuelle elementer gengives ved siden af hinanden, hvilket hjælper brugere, der har brug for skærmforstørrelse.

Lær mere i Inputvalidering.

Brug "errorMessage" til valideringsfeedback

Egenskaben "errorMessage" er tilgængelig for alle inputtyper til at angive den besked, der vises, når en bruger indtaster en ugyldig værdi.

Lær mere i Inputvalidering.

TextBlock med "style": "overskrift" for tilgængelighedsstruktur

Ved brug af "style": "heading" anvender standardoverskriftsstilen, og TextBlock-elementet markeres som en overskrift for tilgængelighed.

Få mere at vide i TextBlock.

Handlingsknapper—"tooltip" til skærmoplæsning

Handlingen "Action.ToggleVisibility" understøtter en "tooltip"-egenskab, der definerer tekst, som vises, når brugeren holder musen over knappen. Fortællersoftware læser denne tekst.

Læs mere i Action.ToggleVisibility.

Forsigtig med "isVisible": "false" for inputelementer

Sørg for, at inputelementer med validering er synlige. Inputelementer med validering under "Action.ToggleVisibility" kan skabe forvirring, når skjulte inputparametre ikke er gyldige.

Læs mere i Action.ToggleVisibility.

Egenskaben "labelPosition" for Input.ChoiceSet

For "Input.ChoiceSet" bestemmer egenskaben "labelPosition" etikettens position, enten indbygget eller ovenfor (standard).

Læs mere om Input.ChoiceSet.

  • Last updated on