Vue Announcer の使い方

Vue Announcer はスクリーンリーダーを使用している人にアプリケーションで何が起こっているかをとても簡単に伝える手段を提供しています。



スクリーンリーダーはどのように動いているか

スクリーンリーダーは支援技術の一つであり、スクリーンに表示されたコンテンツを音声または点字出力に変換することができます。ウェブサイトやブラウザに関して、セマンティック HTML は検索エンジンがウェブページをよりよく理解するための方法であるだけではありません。アプリに「意味のある」(セマンティック)要素を使用することで、スクリーンリーダーのユーザーに情報や機能を伝えることもできます。このように、ウェブサイトがすべての人に知覚されることを保証するために、音声文書の概要、マルチメディアコンテンツの代替テキスト、ラベル付きボタン、フォーム入力、および良識あるリンクテキストが必要です。

スクリーンリーダーの「フォーカス」ポイントである「仮想カーソル」は、ドキュメントの一箇所(この場合、DOM、Document Object Model)にしか同時に配置できません。これは、人差し指で特定の単語を指しながら本のページを読むようなもので、一度に1つの場所で読むことができます。仮想カーソルが HTML ノード上にある場合、その名前、役割、および値がユーザーに読み取られます。このようにして、現在カーソルが置かれている要素が情報(テキスト、マルチメディアなど)を提供しているのか、機能(例:リンク、ボタン)を提供しているのかを知ることができます。

非同期更新の問題

クライアント側でレンダリングされる Web アプリケーションの特徴の1つは、動的な DOM であるということです。ドキュメントの一部は、更新されたり、追加されたり、削除されたりします。これらはすべて、エレガントでスムーズかつ非同期な方法で、ページをリロードすることなく、リアクティブで「アプリケーションのような」体験を提供します。しかし、これはスクリーンリーダーのユーザーにとっては問題があります。文書の最後の三分の一(たとえば、スクリーンリーダーの仮想カーソルがフッターセクションのリンク上にある場合)まで移動し、文書のヘッダーの一部が更新されたとします。あるいは、別のシナリオを考えてみてください。シングルページアプリケーション(SPA)では、スクリーンリーダーユーザーが現在のメイン・ナビゲーションにいて、仮想カーソルがリンクのリストにあります。これにより、「About」ページへのリンクがアクティブになります。SPA なので、ダイナミックドキュメントの一部であるコンテンツエリアのみが更新(ルーティング)されます。しかし、「About」ページに移動した後にスクリーンリーダーから何も通知がなければ、ユーザーは自分の操作がどこで機能したのか疑問に思うことになります。ユーザーは自らコンテンツエリアに移動して確認しなければなりません。新しいページが読み込まれ、そのページタイトルが通知されるために、リンクをクリックして、インタラクションがうまくいったことを知るという、サーバーサイドの体験と比較してみてください。

ライブリージョン

WAI(W3C の Web Accessibility Initiative)が数年前に「ライブリージョン」という概念を確立したのはこのためです。ライブリージョンを使用すると、Web 開発者は、ドキュメント内の現在の仮想カーソルの位置がどこにあるか関係なく、プログラムによってスクリーンリーダーに通知を送信できます。このように Web 開発者のツールボックスには、動的な DOM の更新後に混乱した沈黙を解決するための役立つ項目があります。言うまでもなく、大きな力には大きな責任が伴います。もしスクリーンリーダの「自然な」流れが乱れすぎたり、積極的になりすぎると、補助器具にとっては大きな迷惑の源泉になります。したがって、ライブリージョンは非常に合理的に使用する必要があります。これは、潜在的な苛立たしい沈黙を埋めるための手段です。このようなことから、WAI は2つの一般的なアナウンスモードを提供しました。

  • 1つ目は "polite" と呼ばれるもので、まさにその名の通りのものです。礼儀正しい人間が、何か言いたいことがあるからといって、会話の途中で話を中断したりしないのと同じように、礼儀正しいライブリージョンは、現在進行中のアナウンスが終わるまで待ちます。覚えておいてください。"現在進行中"とは、ほとんどの場合、DOM 内の仮想カーソルの位置に関係しています。
  • 2つ目は、エラーメッセージや非常に重要なことを伝えることに適しています。もしあなたの家が火事になったときに、対話の順番を待つ礼儀正しい人が「外に出て!火事だ!」と叫ぶのは、緊急時を考えるととても不適切です。このタイプのライブリージョンは "assertive" と呼ばれ、スクリーンリーダーの出力をすぐに中断します。

Vue Announcer は、Vue アプリケーションでこれらのライブリージョンを便利に使用する方法を提供しています。 (opens new window).

Vue Announcer と出会う

npm(npm install -S @vue-a11y/announcer)または yarn(yarn add @vue-a11y/announcer)でインストールできます。Vue 3 バージョンの場合は、プロジェクトの次のブランチを指定します。npm(npm install -S @vue-a11y/announcer@next)または yarn(yarn add -D @vue-a11y/announcer@next)。

アプリに組み込むには、インポートしてVueプラグインとして登録します。
とりあえず、Vue 2 の方法で表示してみましょう。

import Vue from 'vue'
import VueAnnouncer from '@vue-a11y/announcer'

Vue.use(VueAnnouncer)

Vue 3 版を使用している場合、コードは以下のようになります。

import { createApp } from 'vue'
import App from './App.vue'
import VueAnnouncer from '@vue-a11y/announcer'

createApp(App)
  .use(VueAnnouncer)
  .mount('#app')

実際に使用する次のステップとしては、例えば以下のように、App.vue<VueAnnouncer /> を追加することです。

<template>
  <div>
    <VueAnnouncer />
    ...
  </div>
</template>
info

<VueAnnouncer /> アプリケーションのどこにでも配置することができます。しかし、vue-announcer を動作させるためには、このカスタム要素を追加しなければなりません。

3つ目のステップは、実際に通知を送ることです。公式ドキュメントを引用すると (opens new window)

Vue インスタンスに注入されたプロパティ上で $announcer が利用可能なので、アプリケーション内のどこでも利用可能です。これを使えば、スクリーンリーダーを持った人に必要な情報をリアルタイムで通知することができます。

まとめると、$announcer は3つのメソッドがあります:

  • set を使用すると、アクセシブルな通知を送信できます。最初のパラメータはメッセージ自体で、2番目のパラメータはメッセージの丁寧さの設定です。具体例:

    this.$announcer.set('Could not save file', 'assertive')
    
  • polite は丁寧さの設定を polite として定義するための "set" メソッドのラッパーです:

    this.$announcer.polite('Added item to your shopping cart')
    
  • assertive は丁寧さの設定を assertive として定義するための "set" メソッドのラッパーです:

    this.$announcer.assertive('Could not save file')
    
tip

Vue 3 バージョンの vue-announcer に関する注釈。プロジェクトの次のブランチでは、Composition API のコンテキストで使用するためのコンポジション可能な useAnnouncer() が提供されています。指定されたエクスポートは、announce (デフォルトは polite)、assertivepolite、そしてルート変更後の使用のための setRouteComplement です。詳細はライブラリの next ブランチの Readme.md (opens new window) を参照してください。

export default {
  setup () {
    const { assertive } = useAnnouncer()

    function someErrorMethod () {
      assertive("Could not save draft");
    }
    // ...
  }
}

より学ぶために

基本的なことはここまでです。 Vue Announcer の公式ドキュメント (opens new window)には、ルート変更時のアナウンス のトリガーに関する拡張情報や、「バニラな」Vue アプリケーション (opens new window)Nuxt.js (opens new window)Vuepress (opens new window) と連携した使用例が掲載されています。




ニュースレターを購読する

メールアドレスを入力すると、記事、ビデオ、アップデート、イベントの情報を Vue.js アクセシビリティコミュニティから受け取ることができます。

MIT Licensed | Copyright © 2020-2022