Suggerimenti per l'accessibilità per le schede adattive

Gli agenti di Copilot Studio funzionano bene con i lettori di schermo su Windows, come NonVisual Desktop Access (NVDA) e Job Access with Speech (JAWS). Per ottimizzare l'accessibilità, considera questi consigli.

Utilità per la lettura dello schermo

Per l'accessibilità tramite lettori di schermo e navigazione da tastiera delle Schede adattive, ecco gli aspetti contano maggiormente.

• Includi sempre la proprietà "label": la proprietà "label" è ciò che i lettori di schermo annunciano quando il focus viene portato su un campo di input. Senza di esso, i lettori di schermo potrebbero dire solo il "campo di modifica" senza contesto. I lettori di schermo spesso non leggono i segnaposto, e questi scompaiono quando l'utente inizia a digitare. Pertanto, evita di affidarti a loro per supportare l'accessibilità.

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

• Usa "inputStyle" e "style" in modo ponderato: evita uno stile personalizzato che elimina gli indicatori di focus. L'anello di focus predefinito è ciò su cui gli utenti della tastiera fanno affidamento per orientarsi sulla scheda.

• Usa "isRequired" ed "errorMessage" per i lettori di schermo: anche per i campi facoltativi, un chiaro "errorMessage" aiuta i lettori di schermo a fornire feedback sulla convalida.

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

• Ordine di tabulazioni logiche: le schede adattive seguono l'ordine DOM (Document Object Model) per la navigazione tramite tab, quindi struttura la rappresentazione JSON della scheda nell'ordine in cui desideri che gli utenti effettuino le tabulazioni. Evita di usare layout "ColumnSet" che creano un ordine visivamente logico ma un ordine di tabulazione confuso per gli utenti che usano la tastiera.

• I pulsanti Action sono accessibili tramite tastiera per impostazione predefinita: proprietà come "Action.Submit" e "Action.OpenUrl" sono attivabili per loro natura. Assicurati che il titolo sia descrittivo, evitando espressioni vaghe come "Fai clic qui", perché i lettori di schermo leggono il titolo ad alta voce.

• Aggiungi "type": "TextBlock" per le istruzioni: se una sezione di campi facoltativi necessita di contesto, imposta "type" come "TextBlock" prima di quei campi. I lettori di schermo leggono i campi uno dopo l'altro, fornendo agli utenti il contesto opportuno prima di raggiungere gli elementi di input.

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

• Evita "isVisible": "false" per gli per scenari di accessibilità: i lettori dello schermo saltano completamente gli elementi nascosti. Se l'accessibilità è la priorità, mantieni visibili i campi facoltativi. Se devi nasconderli, assicurati che l'interruttore abbia un'etichetta chiara e descrittiva.

• Suggerimento per i professionisti per i test in Microsoft Teams: a causa di lievi differenze nel supporto delle schede adattive, è consigliabile usare l'Assistente vocale di Windows predefinito o NVDA per convalidare l'ordine di tabulazioni e che gli annunci funzionino come previsto.

Proprietà specifiche dello schema

Ecco alcune proprietà specifiche nello schema delle Schede adattive che possono aiutare a migliorare l'accessibilità.

La proprietà "Label"

La proprietà "label" è fondamentale per i lettori di schermo. Stabilendo una connessione tra "label" e "input", le librerie di rendering possono impostare le proprietà necessarie per consentire agli utenti di tecnologie assistive, come i lettori di schermo, di interagire correttamente con gli input all'interno delle Schede adattive.

Altre informazioni in Input.Text.

Perché "label" è preferibile a "placeholder" per l'accessibilità?

Consigliamo di usare la proprietà "label" per etichettare i parametri di input delle Schede adattive, invece della proprietà "placeholder". È un modo semplice e conciso per etichettare i parametri di input per gli autori di schede.

L'utilizzo delle proprietà "TextBlock" come etichette impedisce di imporre la vicinanza tra i campi di input e le rispettive etichette. Usando la proprietà "label", puoi assicurarti che entrambi gli elementi visivi vengano visualizzati uno accanto all'altro, il che aiuta gli utenti che devono usare le lenti di ingrandimento dello schermo.

Altre informazioni in Convalida input.

Usare "errorMessage" per il feedback di convalida

La proprietà "errorMessage" è disponibile per tutti i tipi di input e serve a specificare il messaggio da visualizzare quando un utente inserisce un valore non valido.

Altre informazioni in Convalida input.

TextBlock con "style": "heading" per una struttura accessibile

Utilizzando "style": "heading" si applica lo stile predefinito per le intestazioni e si contrassegna l'elemento TextBlock come intestazione per scopi di accessibilità.

Altre informazioni in TextBlock.

Pulsanti d'azione: proprietà "tooltip" per la narrazione

L'azione "Action.ToggleVisibility" supporta una proprietà "tooltip" che definisce il testo che appare quando l'utente passa il mouse sopra l'azione. Il software di narrazione legge questo testo.

Altre informazioni in Action.ToggleVisibility.

Avvertenza quando si imposta "isVisible": "false" per gli elementi di input

Mantieni visibili gli elementi di input con convalida. Gli elementi di input con convalida in "Action.ToggleVisibility" potrebbero generare confusione quando i parametri di input nascosti non sono validi.

Altre informazioni in Action.ToggleVisibility.

La proprietà "labelPosition" per Input.ChoiceSet

Per "Input.ChoiceSet", la proprietà "labelPosition" determina la posizione dell'etichetta, ovvero sulla riga o sopra (predefinita).

Altre informazioni in Input.ChoiceSet.