Mukautuvien korttien helppokäyttöisyysvihjeitä

Copilot Studio agentit toimivat hyvin Windowsin näytönlukuohjelmien, kuten NVDA (NonVisual Desktop Access) ja JAWS (Job Access with Speech), kanssa. Helppokäyttöisyyden optimoinnissa kannattaa huomioida nämä vinkit.

Näytönlukuohjelmat

Mukautuvien korttien näytönlukuohjelman ja näppäimistösiirtymisen helppokäyttötoiminnoissa seuraavat seikat ovat olennaisimpia.

  • Sisällytä aina "label"-ominaisuus: Juuri "label"-ominaisuuden näytönlukuohjelmat ilmoittavat, kun käyttäjä kohdistaa syötteeseen. Ilman sitä näytönlukuohjelmat saattavat sanoa vain Muokkaa kenttää, ilman kontekstia. Näytönlukuohjelmat eivät usein lue paikkamerkkejä, ja ne häviävät, kun käyttäjä aloittaa kirjoittamisen. Älä tämän vuoksi luota niihin helppokäyttötoimintojen apuna.

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

  • Käytä "inputStyle"- ja "style"-ominaisuuksia harkiten: Vältä kohdistusilmaisimet poistavia mukautettuja tyylejä. Näppäimistön käyttäjät paikantavat sijainnin kortissa oletuskohdistusrenkaan avulla.

  • Käytä "isRequired"- ja "errorMessage"-ominaisuuksia näytönlukuohjelmissa: selkeä "errorMessage" myös valinnaisissa kentissä auttaa näytönlukuohjelmia antamaan validointipalautetta.

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

  • Looginen sarkainjärjestys: Mukautetut kortit noudattavat DOM (Document Object Model) -järjestystä sarkaimella siirryttäessä, joten rakenna kortin JSON-esitys siihen järjestykseen, jossa käyttäjien halutaan siirtyvän sarkainta käytettäessä. Vältä sellaisten "ColumnSet"-asettelujen käyttöä, jotka luovat visuaalisesti loogisen järjestyksen mutta luovat näppäimistökäyttäjien kannalta hämmentävän sarkainjärjestyksen.

  • Toimintopainikkeita voi oletusarvoisesti käyttää näppäimistöllä: Ominaisuudet, kuten "Action.Submit" ja "Action.OpenUrl" ovat luonnostaan kohdistettavia. Varmista, että otsikko on kuvaileva eikä epämääräinen, kuten Napsauta tätä, sillä näytönlukuohjelmat lukevat otsikon ääneen.

  • Lisää "type": "TextBlock" ohjeita varten: Jos valinnaisten kenttien osio tarvitsee kontekstia, määritä "type"-arvoksi "TextBlock" ennen näitä kenttiä. Näytönlukuohjelmat lukevat kentät järjestyksessä ja antavat käyttäjille kontekstin, jota tarvitaan ennen syötteitä.

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

  • Vältä "isVisible": "false" -ominaisuuden käyttöä helppokäyttötoimintoskenaarioissa: Näytönlukuohjelmat ohittavat piilotetut elementit kokonaan. Jos helppokäyttötoiminnot ovat ensisijaisia, pidä valinnaiset kentät näkyvissä. Jos ne on piilotettava, varmista, että vaihtopainikkeella on selkeä ja kuvaileva selite.

  • Microsoft Teamsissa testaamisen ammattilaisvinkki: koska Microsoft Teamsin mukautettujen korttien tuki on hieman erilainen, sarkainjärjestyksen ja ilmoitusten odotustenmukaisen toiminnan validointiin on suositeltavaa käyttää sisäänrakennettua Windows Lukijaa tai NVDA:ta.

Rakenteen ominaisuuksia

Seuraavat mukautetun korttirakenteen ominaisuudet auttavat parantamaan helppokäyttötoimintoja.

"Label"-ominaisuus

"Label"-ominaisuus on olennaisen tärkeä näytönlukuohjelmille. Selitteiden ja syötteiden välisen yhteyden ansiosta muodostinkirjastot voivat määrittää ominaisuudet, joita tarvitaan antamaan avustavien teknologioiden, kuten näytönlukuohjelmien, käyttäjille mahdollisuus käyttää mukautuvien korttien syötteitä oikein.

Lisätietoja kohdassa Input.Text.

Miksi "label" on helppokäyttötoimintojen kannalta parempi kuin vaihtoehto kuin "placeholder"?

On suositeltavaa käyttää "label"-ominaisuutta mukautuvien korttien syöteparametrien merkitsemiseen "placeholder"-ominaisuuden sijaan. Se on yksinkertainen ja ytimekäs tapa, jolla kortin tekijät voivat merkitä syötteitä.

"TextBlock"-ominaisuuksien käyttäminen selitteinä estää varmistamasta, että syötteet ja selitteet ovat lähekkäin. Käyttämällä "label"-ominaisuutta voidaan varmistaa, että molemmat visuaaliset elementit hahmonnetaan vierekkäin, mikä auttaa suurennuslasia tarvitsevia käyttäjiä.

Lisätietoja on kohdassa Syötteiden tarkistus.

"errorMessage"-ominaisuuden käyttö tarkistuksen palautteessa

"errorMessage"-ominaisuutta voi käyttää kaikissa syötetyypeissä määrittämään viesti, joka näytetään, kun käyttäjä syöttää virheellisen arvon.

Lisätietoja on kohdassa Syötteiden tarkistus.

TextBlock ja tyyli: otsikko helppokäyttötoimintojen rakennetta varten

"style": "heading" -ominaisuuden käyttäminen käyttää oletusotsikon tyyliä ja merkitsee TextBlock-elementin helppokäyttötoiminnon otsikkona.

Lisätietoja on kohdassa TextBlock.

Toimintopainikkeet – "tooltip"-ominaisuus selostusta varten

"Action.ToggleVisibility"-toiminto tukee "tooltip"-ominaisuutta, joka määrittää näkyviin tulevan tekstin, kun käyttäjä siirtää hiiren toimintopainikkeen päälle. Selostusohjelmisto lukee tämän tekstin.

Lisätietoja on kohdassa Action.ToggleVisibility.

"isVisible": "false" -ominaisuuden käyttö syöte-elementeissä koskeva varoitus

Pidä tarkistuksen sisältävät elementit näkyvissä. Syöte-elementit, jotka sisältävät tarkistuksen "Action.ToggleVisibility"-ominaisuudessa, saattavat aiheuttaa hämmennystä, jos piilotetut syöteparametrit eivät kelpaa.

Lisätietoja on kohdassa Action.ToggleVisibility.

Input.ChoiceSet-syötteen "labelPosition"-ominaisuus

"Input.ChoiceSet"-syötteessä "labelPosition"-ominaisuus määrittää selitteen sijainnin joko riville tai sen yläpuolelle (oletus).

Lisätietoja on kohdassa Input.ChoiceSet.

  • Last updated on