Oracle JETアプリケーションでのマスター・ディテール・ビューのアクセシビリティの検証
はじめに
「キーボードのみのアクセシビリティのためのOracle JETアプリケーションのテスト」チュートリアルでは、「組織」タブ内のアクセシビリティに関するいくつかの問題に対処しました。このチュートリアルで対処するいくつかの問題があります
目的
このチュートリアルでは、ACCLearningPath
アプリケーションの「組織」タブでアクセシビリティの問題を識別および修正する方法を学習します。
前提条件
- JavaScriptランタイム、Node.jsおよびOracle JETリリース13.0以降のコマンドライン・インタフェースがインストールされたOracle JETアプリケーションを作成するように設定された開発環境
- Oracle JET開発者クックブックへのアクセス
- Webコンテンツ・アクセシビリティ・ガイドライン2.2へのアクセス
- Oracle JETキーボードおよびジェスチャ・ガイドへのアクセス
- この学習パスの前のチュートリアルの「接続ライフサイクル・イベントのカスタマイズ」を完了します
タスク1: ページ構造のレビュー
アプリを確認する最初のステップは、ページ構造を確認することです。アプリケーションを実行し、「組織」タブに必要なHTMLヘッダーがあることを確認します。
-
アプリケーションがブラウザで実行されていない場合は、ターミナルを使用して、
ACCLearningPath
ディレクトリからアプリケーションを起動します。$ ojet serve
-
概要ページのタブ・バーの「組織」タブをクリックします。
スクリーンショットでは、「組織」ページに2つのパネルがあります。左側のパネルはツリー・ビューを保持し、右側のパネルはツリー・ビューの使用手順を示します。
次のWCAG成功基準に従って、ページの各セクションに識別するHTMLヘッダーがあるかどうかを判断します。
- 「WCAG達成基準1.3.1の情報と関係」および「WCAG達成基準2.4.10セクション見出し」は、タブ自体と各パネルに目的を定義するHTML見出しがあることを示します。
-
ACCLearningPath/src/js/views
フォルダに移動し、エディタでorganization.html
ファイルを開きます。 -
最上位の
<div>
タグを見つけて、その後に<h3>
見出しタグを挿入します。<div class="oj-hybrid-padding"> <h3>Organization</h3>
-
ツリー・ビューで左パネルを形成する
<div>
タグを探し、その後に<h4>
見出しタグを挿入します。<div class="oj-flex-item"> <h4>Organization Tree View</h4>
-
「組織」ページの右パネルを形成する
<div>
タグを探し、その後に<h4>
見出しタグを挿入します。<div class="oj-flex-item oj-sm-6"> <h4>Employee Details</h4>
-
保存してファイルを閉じます。ファイルはorganization-page1-html.txtのようになります。
ブラウザによってページがリフレッシュされ、「組織」ページへの変更が選択されます。
-
ページ構造が正しいことを確認します。
タスク2: キーボードのみのテストの実行
-
<Ctrl+L>
を押して、アドレス・バーにフォーカスを設定します。 -
<Tab>
を押します。フォーカスが移動すると、ナビゲーションのスキップ・リンクに移動します。 -
<Tab>
を押します。ページの右上にあるユーザー・メニューのjohn.hancock@oracle.comにフォーカスが移動します。 -
<Tab>
を押します。ページの右上にあるユーザー・メニューのすぐ下にあるナビゲーション・メニューで、フォーカスが「概要」に移動します。 -
<Tab>
を押します。フォーカスがタブ・バーの「概要」に移動します。 -
<Tab>
を押します。左側のパネルのツリー・ビューの「会計」アイテムにフォーカスが移動します。 -
ツリー・ビューで
<down arrow>
を2回押して、従業員にフォーカスを設定します。 -
<Enter>
を押して従業員を選択し、ページの右パネルで「従業員詳細」フォームを表示します。 -
<Tab>
を押します。フォーカスが「従業員ID」フィールドに移動します。 -
<Tab>
を押します。フォーカスが「従業員名」フィールドに移動します。 -
<Tab>
を押します。フォーカスが「ジョブ・タイトル」コンボボックスに移動します。 -
<Tab>
を押します。フォーカスが [採用日]フィールドに移動します。 -
<Tab>
を押します。フォーカスが「給与」スピンボックスに移動します。 -
<Tab>
を押します。フォーカスが「マネージャID」フィールドに移動します。 -
<Tab>
を押します。フォーカスが「ジョブ」ラジオ・ボタンに移動します。 -
<Tab>
を押します。フォーカスがページのフッターの「Oracleについて」リンクに移動します。フォーカス長方形がこのテスト全体を通して表示され、フォーカスが予想される順序で移動する場合、「組織」ページはフォーカス・インジケータ基準を満たします。
タスク3: スクリーン・リーダー検証の実行
アクセシビリティについて「組織」ページをテストする最終段階は、スクリーン・リーダー検証を実行して、スクリーン・リーダーが必要とするすべてを話せるようにすることです。
WCAG達成基準4.1.2の名前、ロール、値および達成基準2.4.4リンク目的(コンテキスト内)に従って、検証する必要がある主な項目は次のとおりです。
- すべてのコントロールの名前、ロール、状態および値が指定されます。
- すべてのリンクのテキストが話され、リンクの目的が適切に説明されています。
-
ターミナル・ウィンドウで、
<Ctrl+C>
を押して実行中のアプリケーションを終了し、プロンプトが表示されたらy
と入力します。 -
スクリーン・リーダーを起動し、Webアプリケーションを再起動します。
$ ojet serve
アプリは自動的にブラウザーで開かれ、ページの読み込みが完了すると、スクリーンリーダーが読み込みを開始します。
-
タブ・バーから「組織」タブを選択し、残りのステップにのみキーボードを使用します。
-
<Ctrl+L>
を押して、アドレス・バーにフォーカスを設定します。 -
<Tab>
を押します。JAWSでは、「メイン・コンテンツにスキップ」と表示されます。同じページのリンク>> -
<Tab>
を押します。JAWSでは、「バナー・リージョン」と表示されます。ツールバー。john.hancock@oracle.comボタン・メニュー。[Space]を押してメニューをアクティブ化し、矢印キーで移動します。 -
<Tab>
を押します。JAWSでは、「ナビゲーション・リージョン」タブが表示されます。「紹介」タブが選択されました。1/2です。 -
<Tab>
を押します。JAWSでは、「メイン・リージョン・タブ。「組織」タブが選択されました。2/4です。」 -
<Tab>
を押します。フォーカスがツリー・ビューの最初のアイテムである「会計」に移動し、JAWSが「ノードのデータを受信: research」と表示します。会計です。研究: ジョーンズ、スコット、フォード、アダムズ。販売。操作プレビュー。会計がクローズされました。1/4。項目間の移動や項目の展開には、矢印キーを使用します。スクリーン・リーダーがツリー・ビューの説明ラベルを示していないことに注意してください。ツリー・ビューに適切なラベルを提供するために必要な修正が2つあります。
-
ツリー・ビュー・ラベルを修正するには、
ACCLearningPath/src/js/views
フォルダに移動し、エディタでorganization.html
ファイルを開きます。 -
<oj-tree-view>
タグを見つけます。<oj-tree-view id="treeview" data="[[dataProvider]]" selection-mode="single" . . .
-
<oj-tree-view>
タグに次のaria-label
属性を追加します。h4
HTML見出しは、ツリー・ビューのビジュアル・ラベルとして機能します。<oj-tree-view id="treeview" data="[[dataProvider]]" selection-mode="single" aria-label="Organization Tree View - select an employee to display details." . . .
ツリー・ビューは、「WCAG達成基準2.5.3名前ラベル」と「WCAG達成基準1.3.1情報および関係」の両方に準拠するようになりました。これらの基準を満たすには、ビジュアル・ラベルとインストラクション・テキストの両方をコントロールの音声ラベルに含める必要があります。
-
ブラウザ・ウィンドウに戻り、前述のステップ1から7を繰り返して、ツリー・ビューの「会計」に焦点を当てます。JAWSでは、「組織ツリー・ビュー- 詳細を表示する従業員を選択します。ツリー・ビュー会計がクローズされました。1/4。項目間の移動や項目の展開には、矢印キーを使用します。
-
<right arrow>
を押します。スクリーンリーダーは、「ノード: アカウンティングのデータを取得しています。会計オープン。1/4。会計はオープンしています。ノードのデータを受信: accounting" -
<right arrow>
を押します。スクリーンリーダーは「レベル1」と言います。ワンギン1/3項目間の移動や項目の展開には、矢印キーを使用します。 -
<down arrow>
を押します。スクリーンリーダーは「クラーク」と言います。 -
<Enter>
を押して、Clarkを選択します。スクリーンリーダーは「Clark. 2 of 3」と言います。 -
<Tab>
を押します。スクリーン・リーダーには、「Employee Id read-only edit 7,782」と表示されています。 -
<Tab>
を押します。スクリーン・リーダーは、「従業員名はClarkを編集します。テキストを入力します。 -
<Tab>
を押します。スクリーン・リーダーは、「ジョブ・タイトル編集コンボ」と言います。管理者。値を設定するには、矢印キーを使用するか、値を入力します。 -
<Tab>
を押します。スクリーン・リーダーには、「Hire Date edit combo」と表示され、その後に要素内に存在する日付「06/08/1981」が続きます。次に、カレンダーに表示される情報の読み取りと、データの移動とアクセスの手順を示します。 -
<Tab>
を押します。スクリーンリーダーは「給与編集スピンボックス。2,450。0以上の数値を入力してください。値を設定するには、矢印キーを使用するか、値を入力します。 -
<Tab>
を押します。スクリーンリーダーに「Manager Id、 read-only edit. 7839」と書かれている。 -
<Tab>
を押します。スクリーンリーダーは「Accounting radio button checked. 1 of 4」と表示しています。スクリーン・リーダーは、ラジオ・ボタンのセットのラベルを発表していないことに注意してください。
-
ラジオ・ボタン・セット・ラベルを修正するには、
organization.html
ファイルで<oj-radioset>
タグを見つけます。<oj-radioset id="dept-id" options="[[depsDataProvider]]" value="[[empDetails().deptno]]"> </oj-radioset>
-
<oj-radioset>
タグにlabel-hint="Departments"
属性を追加して、ラジオ・ボタンのセットの表示ラベルと使用ラベルを指定します。<oj-radioset id="dept-id" label-hint="Departments" options="[[depsDataProvider]]" value="[[empDetails().deptno]]"> </oj-radioset>
-
保存してファイルを閉じます。ファイルは
organization-page2-html.txt
のようになります。 -
ブラウザによって実行中のアプリケーションがリフレッシュされ、「組織」ページへの変更が反映されます。
-
スクリーンリーダー検証を再実行して、新しいラベルが話されていることを確認します。
-
スクリーンリーダーを停止します。
-
ターミナル・ウィンドウで、
<Ctrl+C>
を押してアプリケーションを終了し、プロンプトが表示されたらy
と入力します。
これで、2番目のアクセシビリティ修正セットが完了しました。
次のステップ
このチュートリアルは、「アプリケーションのアクセシビリティの検証および修正」モジュールの一部です。
- 接続されたライフサイクル・イベントのカスタマイズ
- Oracle JETアプリケーションのマスター・ディテール・ビューのアクセシビリティの検証
- Oracle JETコンポーネントの表およびメッセージのアクセシビリティの検証
- 複合Oracle JETコンポーネントでのキーボード・ナビゲーションのテスト
アクセシビリティ学習パスのメイン・ページに戻ると、アクセシビリティのすべてのモジュールにアクセスできます。
その他の学習リソース
docs.oracle.com/learnで他のラボを確認するか、Oracle Learning YouTubeチャネルで無料のラーニング・コンテンツにアクセスしてください。また、education.oracle.com/learning-explorerにアクセスして、Oracle Learning Explorerになります。
製品ドキュメントについては、Oracle Help Centerを参照してください。
Validate the accessibility of master detail views in an Oracle JET app
F58377-02