Tip til hjælp til handicappede til Adaptive Cards

Copilot Studio-agenter fungerer godt sammen med skærmlæsere i Windows, f.eks. NonVisual Desktop Access (NVDA) og Job Access with Speech (JAWS). Overvej disse tip for at optimere tilgængeligheden.

Skærmlæsere

For tilgængeligheden af skærmlæsere og tastaturnavigation for adaptive kort er det her, der er vigtigst.

  • Medtag altid egenskaben "etiket": Egenskaben "etiket" er den, skærmlæsere annoncerer, 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 stole på, at de hjælper med tilgængelighed.

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

  • Brug "inputStyle" og "style" eftertænksomt: Undgå brugerdefineret formatering, der fjerner fokusindikatorer. Standardfokusringen er det, som tastaturbrugerne er afhængige af for at vide, hvor de er på kortet.

  • Brug "isRequired" og "errorMessage" til læserne: Selv for valgfrie felter hjælper en klar "errorMessage" skærmlæsere med at kommunikere valideringsfeedback.

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

  • Logisk tabulatorrækkefølge: Adaptive kort følger DOM-rækkefølgen (Document Object Model) for fanenavigation, så strukturér JSON-repræsentationen af kortet i den rækkefølge, brugerne skal bruge tabulatortasten i. Undgå at bruge layout af typen "ColumnSet", der opretter en visuelt logisk rækkefølge, men en forvirrende tabulatorrækkefølge for tastaturbrugere.

  • Handlingsknapper er som standard tilgængelige på tastaturet: Egenskaber som f.eks. "Action.Submit" og "Action.OpenUrl" kan oprindeligt fokuseres på. Sørg for, at titlen er beskrivende i stedet for noget vagt, f.eks. "Klik her", fordi skærmlæsere læser titlen højt.

  • Tilføj "type": "TextBlock" for at få instruktioner: Hvis en sektion af valgfrie felter skal bruge kontekst, skal du angive "type" som "TextBlock" før disse felter. Skærmlæsere læser felter i rækkefølge, så brugerne får den kontekst, de har brug for, før de når inputtet.

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

  • Undgå "isVisible": "false" for tilgængelighedsscenarier: Skærmlæsere springer helt skjulte elementer over. Hvis tilgængelighed er prioriteten, skal du bevare valgfrie felter synlige. Hvis du skal skjule dem, skal du sikre, at til/fra-knappen har en tydelig, beskrivende mærkat.

  • Pro-tip til test i Microsoft Teams: På grund af små forskelle i Microsoft Teams-understøttelse af adaptive kort anbefaler vi, at du bruger den indbyggede Windows Oplæser eller NVDA til at validere tabulatorrækkefølgen, og at meddelelser fungerer som forventet.

Specifikke skemaegenskaber

Her er nogle specifikke egenskaber i skemaet adaptive kort, der kan hjælpe med at forbedre tilgængeligheden.

Egenskaben "etiket"

Egenskaben "etiket" er vigtig for skærmlæsere. Ved at have en forbindelse mellem mærkater og input kan gengivelsesbiblioteker angive de nødvendige egenskaber for at give brugere af hjælpeteknologier, f.eks. skærmlæsere, mulighed for at interagere korrekt med input i adaptive kort.

Få mere at vide i Input.Text.

Hvorfor er "etiket" bedre end "pladsholder" med hensyn til adgang?

Vi anbefaler, at du bruger egenskaben "etiket" til mærkning af inputparametre for adaptive kort i stedet for egenskaben "pladsholder". Det er en enkel og præcis måde at navngive input til kortforfattere på.

Hvis du bruger egenskaberne "TextBlock" som mærkater, kan du ikke gennemtvinge nærhed mellem input og etiketter. Ved hjælp af egenskaben "etiket" kan du sikre, at begge visuelle elementer gengives ved siden af hinanden, hvilket hjælper brugere, der har brug for skærmforstørrelsesglas.

Få mere at vide i Inputvalidering.

Brug "errorMessage" til valideringsfeedback

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

Få mere at vide i Inputvalidering.

TextBlock med "style": "heading" til brug i tilgængelighedsstrukturen

Brug af "style": "heading" anvender standardformatet for overskriften og markerer TextBlock-elementet som en overskrift for tilgængelighed.

Få mere at vide i TextBlock-element.

Handlingsknapper – "værktøjstip" til indtalinger

Handlingen "Action.ToggleVisibility" understøtter en egenskab af typen "værktøjstip", der definerer tekst, der vises, når brugeren holder musen over handlingen. Indtalingssoftwaren læser denne tekst.

Få mere at vide i Action.ToggleVisibility.

Advarsel med "isVisible": "false" for inputelementer

Bevar inputelementer med validering synlig. Inputelementer med validering under "Action.ToggleVisibility" kan skabe forvirring, når skjulte inputparametre ikke er gyldige.

Få mere at vide i Action.ToggleVisibility.

Egenskaben "labelPosition" for Input.ChoiceSet

For "Input.ChoiceSet" bestemmer egenskaben "labelPosition" placeringen af etiketten enten i linje eller over (standard).

Få mere at vide i Input.ChoiceSet.

  • Last updated on