Hjälpmedelstips för adaptiva kort

Copilot Studio-agenter fungerar bra med skärmläsare i Windows, till exempel NVDA (NonVisual Desktop Access) och Job Access with Speech (JAWS). Tänk på de här tipsen för att optimera tillgängligheten.

Skärmläsare

För skärmläsare och tangentbordsnavigeringstillgänglighet för adaptiva kort är det här det viktigaste.

• Inkludera alltid egenskapen "etikett": Egenskapen "etikett" är vad skärmläsare meddelar när en användare fokuserar på indata. Utan det kan skärmläsare bara säga "redigera fält" utan kontext. Skärmläsare läser ofta inte platshållare och försvinner när användaren börjar skriva. Undvik därför att förlita dig på dem för att hjälpa till med tillgängligheten.

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

• Använd "inputStyle" och "style" eftertänksamt: Undvik anpassad formatering som tar bort fokusindikatorer. Standardfokusringen är vad tangentbordsanvändare förlitar sig på för att veta var de befinner sig på kortet.

• Använd "isRequired" och "errorMessage" för läsare: Även för valfria fält hjälper ett tydligt "errorMessage" skärmläsare att kommunicera valideringsfeedback.

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

• Logisk flikordning: Adaptiva kort följer DOM-ordningen (Document Object Model) för fliknavigering, så strukturera JSON-representationen av kortet i den ordning du vill att användarna ska navigera genom flikarna. Undvik att använda "ColumnSet"-layouter som skapar en visuellt logisk ordning men en förvirrande flikordning för tangentbordsanvändare.

• Åtgärdsknappar är tangentbordstillgängliga som standard: Egenskaper som "Action.Submit" och "Action.OpenUrl" är inbyggda. Kontrollera att rubriken är beskrivande snarare än något vagt som "Klicka här" eftersom skärmläsare läser rubriken högt.

• Lägg till "type": "TextBlock" för instruktioner: Om ett avsnitt av valfria fält behöver kontext anger du "type" som "TextBlock" före dessa fält. Skärmläsare läser fält i följd, vilket ger användarna den kontext de behöver innan de når indata.

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

• Undvik "isVisible": "false" för hjälpmedelsscenarier: Skärmläsare hoppar över dolda element helt. Om tillgänglighet är prioriteten, se till att valfria fält är synliga. Om du måste dölja dem kontrollerar du att växlingsknappen har en tydlig, beskrivande etikett.

• Proffstips för testning i Microsoft Teams: På grund av små skillnader i Microsoft Teams-stöd för Adaptive Cards rekommenderar vi att du använder den inbyggda Windows Skärmläsaren eller NVDA för att verifiera flikordningen så att meddelanden fungerar som förväntat.

Specifika schemaegenskaper

Här följer några specifika egenskaper i schemat adaptiva kort som kan hjälpa dig att förbättra tillgängligheten.

Egenskapen "etikett"

Egenskapen "etikett" är viktig för skärmläsare. Genom att ha en anslutning mellan etiketter och indata kan återgivningsbibliotek ange de egenskaper som krävs för att göra det möjligt för användare av hjälpmedelstekniker, till exempel skärmläsare, att interagera korrekt med indata i adaptiva kort.

Läs mer i Input.Text.

Varför "etikett" slår "platshållare" för tillgänglighet?

Vi rekommenderar att du använder egenskapen "etikett" för att tagga indataparametrar för adaptiva kort i stället för egenskapen "platshållare". Det är ett enkelt och koncist sätt att märka indata för kortskapare.

Om du använder "TextBlock"-egenskaper som etiketter hindrar du dig från att framtvinga närhet mellan indata och etiketter. Genom att använda egenskapen "etikett" kan du se till att båda de visuella elementen återges bredvid varandra, vilket hjälper användare som behöver skärmförstorare.

Läs mer i Indataverifiering.

Använd "errorMessage" för valideringsfeedback

Egenskapen "errorMessage" är tillgänglig för alla indatatyper för att ange meddelandet som ska visas när en användare anger ett värde som inte är giltigt.

Läs mer i Indataverifiering.

Textblock med "style": "heading" för tillgänglighetsstruktur

Med "style": "heading" tillämpar man standardrubrikens format och markerar TextBlock-elementet som en rubrik för tillgänglighet.

Läs mer i TextBlock-element.

Åtgärdsknappar – verktygstips för beskrivande text

Åtgärden "Action.ToggleVisibility" stöder en knappbeskrivningsegenskap som definierar text som visas när användaren hovrar musen över åtgärden. Berättarprogrammet läser den här texten.

Läs mer i Action.ToggleVisibility.

Varning med "isVisible": "false" för indataelement

Håll indataelement med validering synligt. Indataelement med validering under "Action.ToggleVisibility" kan generera förvirring när dolda indataparametrar inte är giltiga.

Läs mer i Action.ToggleVisibility.

Egenskapen "labelPosition" för Input.ChoiceSet

För "Input.ChoiceSet" avgör egenskapen "labelPosition" etikettens position, antingen i linje eller ovan (standard).

Läs mer i Input.ChoiceSet.