複雜 Oracle JET 元件中的測試鍵盤導覽

簡介

這將是我們第一次瀏覽 ACCLearningPath 應用程式中的「部門」頁籤。此輔助功能系列中先前學習路徑所概述的複查程序,是用來識別任何輔助功能問題。

目標

在本教學課程中,您將瞭解如何在 ACCLearningPath 應用程式的「部門」頁籤中識別及修正輔助功能問題。

必備條件

作業 1:複查頁面結構

  1. 在您的終端機視窗中,瀏覽至 ACCLearningPath 資料夾並執行應用程式。

    $ ojet serve
    

    瀏覽器中的應用程式會開啟「簡介」頁面,其中已載入「概觀」頁籤。

  2. 按一下頁籤列中的「部門」頁籤,並評估頁面結構。「部門」頁面由三個面板組成,其中每個面板都使用各種 Oracle JET 元件顯示部門資料。

    之前的部門頁標

  3. 瀏覽至 ACCLearningPath/src/js/views 資料夾,然後在程式碼編輯器中開啟 departments.html 檔案。

  4. 在檔案中尋找主要 <div> 標記。

    <div class="oj-hybrid-padding">
       <div id="mainContainer" class="oj-flex" style="width:100%;">
    
  5. 在兩個 <div> 標記之間插入 h3 標題,以識別「部門」頁面。

    <div class="oj-hybrid-padding">
       <h3>Departments</h3>
       <div id="mainContainer" class="oj-flex" style="width:100%;">
    
  6. 尋找定義中間面板 (包含影片) 的 <div> 標記。

    <div class="oj-flex-item fs-container">
       <oj-film-strip id="deptFilmstrip" max-items-per-page="1"
          . . . >
    
  7. 在開啟的 <div><oj-filmstrip> 標籤之間插入 h4 標題,以識別面板並提供影片的可見標籤。

    <div class="oj-flex-item fs-container">
       <h4>Departments Film Strip</h4>
       <oj-film-strip id=“deptFilmstrip” max-items-per-page=“1”
          . . . >
    
  8. 尋找構成包含資料方格之左側面板的 <div> 標記。

    <div class="oj-flex-item">
       <oj-data-grid id="datagrid"
          style="width:100%; min-width:400px; height:200px; margin-bottom:5px"
          . . . >
    
  9. <div><oj-data-grid> 標記之間插入 h4 標題,以識別面板並提供資料方格的可見標籤。

    <div class="oj-flex-item">
       <h4>Departments Data Grid</h4>
       <oj-data-grid id="datagrid"
          style="width:100%; min-width:400px; height:200px; margin-bottom:5px"
          . . . >
    
  10. 尋找構成包含圖表之第三個面板的開始 <div> 標記。

      <div class="oj-flex-item oj-sm-margin-4x-horizontal">
         <oj-chart id="pieChart" type="bar" data="[[chartDataProvider]]" animation-on-display="auto" animation-on-data-change="auto"
            . . . >
    
  11. 在開頭的 <div><oj-chart> 標記之間插入 h4 標題。此標題可識別面板,並作為圖表的視覺標籤。

      <div class="oj-flex-item oj-sm-margin-4x-horizontal">
         <h4>Salaries by Department</h4>
         <oj-chart id="pieChart"
            type="bar"
            data="[[chartDataProvider]]"
            animation-on-display="auto"
            animation-on-data-change="auto"
            . . . >
    
  12. 儲存檔案。在瀏覽器中,驗證您應用程式之「部門」頁籤的變更。

    之後的部門頁標

工作 2:執行僅鍵盤測試

輔助功能複查的第二部分是針對應用程式的「部門」頁籤執行僅鍵盤的測試。

  1. <Ctrl+L> 即可將焦點設為網址列。

  2. <Tab>。焦點會移至略過瀏覽連結。

  3. <Tab>。焦點會移至頁面右上角的使用者功能表中的 john.hancock@oracle.com

  4. <Tab>。焦點會移至使用者功能表下方的導覽功能表中的簡介

  5. <Tab>。焦點會移至頁籤列中的總覽

  6. <Tab>。焦點會移至影片片段中的會計

  7. <right arrow> 可移至影片區中的下一個項目 Research

  8. <left arrow> 以返回影片帶中的會計

  9. <right arrow> 三次。焦點會移至影片片段作業中的最後一個項目。

  10. <Tab>。焦點會移至資料方格中 Id 資料欄下的第一個資料主體儲存格。焦點儲存格的值為 10。

  11. <right arrow>。焦點會移至資料方格名稱第二欄下的會計

  12. <right arrow>。焦點會移至資料方格位置的最後一個欄中的紐約

    請注意,焦點輪廓會出現在包含城市名稱的儲存格周圍。

  13. <F2>。焦點大綱僅圍繞儲存格中的文字 New York

    根據 <oj-data-grid> 元素的鍵盤文件,使用 <F2> 讓儲存格的內容可以執行。<F2> 函數鍵可讓您起始作用中元件支援的動作。在此情況下,儲存格會包含您將啟用的「Google 地圖」連結。

  14. <Enter> 以啟用 New York 連結。新的瀏覽器視窗便會開啟至紐約的 Google Maps 頁面。

  15. <Ctrl+F4> 以關閉「Google 地圖」視窗。

  16. <Esc>。焦點會加寬以圍繞第三欄中包含 New York 的儲存格。

    根據 <oj-data-grid> 元素的鍵盤說明文件,使用 <Esc> 結束可操作模式,讓您繼續瀏覽至其他元件。

  17. <Tab>。焦點會移至長條圖中的第一個長條。

工作 3:執行螢幕讀取器驗證

輔助功能複查的最後一個部分是畫面讀取器驗證。下列驗證步驟是以使用 JAWS 螢幕助讀程式為基礎,但如果您使用 NVDA 螢幕助讀程式,結果將會類似。

  1. 在終端機視窗中,按 <Ctrl+C> 結束執行中的應用程式,如果出現提示,請輸入 y

  2. 啟動螢幕助讀程式,然後重新啟動 Web 應用程式。

    $ ojet serve
    

    您的應用程式將自動在您的瀏覽器中開啟;一旦頁面完全載入,螢幕助讀程式就會開始閱讀。

  3. 按一下頁籤列中的「部門」頁籤。請不要在此刻之後使用滑鼠。

  4. <Ctrl+L> 可將焦點設為網址列。

  5. <Tab>。JAWS 讀取,「跳至主要內容」。相同的頁面連結。」

  6. <Tab>。JAWS 表示:「橫幅區域」。工具列。john.hancock@oracle.com 按鈕功能表。按空格鍵以啟用功能表,然後使用方向鍵進行瀏覽。」

  7. <Tab>。JAWS 表示:「導覽區域」頁籤。已選取「簡介」頁標。第 1 頁,共 2 頁。」

  8. <Tab>。JAWS 說:「主要區域」頁籤。已選取部門頁標。4 之 4。」

  9. <Tab> 將焦點移至底片。JAWS 說:「會計」。紐約。3 名員工。顯示第 1 頁,共 4 頁。」

  10. <Tab> 可將焦點移至資料方格。JAWS 表示:「這是包含 4 列與 3 欄的資料方格。ID。名稱。地點。」讀取資料欄標頭之後,螢幕助讀程式會從左至右讀取表格的資料主體儲存格。然後,它會讀取目前的焦點「資料列 1」。資料欄 1。ID:10。」

  11. <right arrow>。JAWS 說:「第 2 欄。名稱:會計。

  12. <right arrow>。JAWS 說:「第 3 欄。地點:紐約。包含控制項。您已到達最後一個資料欄。」

  13. <Tab>。JAWS 表示:「資料視覺化:圖表」。圖形。系列:會計;群組:部門;值:USD 3,750.00。圖形。

    請注意,當焦點在面板之間移動時,JAWS 不會顯示面板標題。沒有辦法將影片從頁面捲動到頁面。

  14. 在程式碼編輯器中開啟 departments.html 檔案。

  15. 尋找開始的 <oj-film-strip> 標記並新增 aria-label 屬性。

      <oj-film-strip id="deptFilmstrip"
         max-items-per-page="1"
         aria-label="Departments Film Strip - Use the paging controls in the next region to change pages."
         arrow-visibility="hidden"
         class="demo-stretch-items"
         . . . >
    
  16. 尋找開始的 <oj-data-grid> 標記並新增 aria-label 屬性。

      <oj-data-grid id="datagrid"
         style="width:100%; min-width: 400px; height:200px;margin-bottom:5px"
         aria-label="Departments Data Grid -- Press enter on the city name to open a google map of the city."
         data="[[dgDataProvider]]"
         header.column.style="[[getCellWidth]]"
         . . . >
    
  17. 尋找開始的 <oj-chart> 標記並新增 aria-label 屬性。

      <oj-chart id="pieChart"
         type="bar"
         aria-label="Salaries by Department bar chart"
         data="[[chartDataProvider]]"
         animation-on-display="auto"
         animation-on-data-change="auto"
         . . . >
    

    最終變更涉及中間面板中影片帶的分頁控制項。

  18. 尋找結束的 </oj-film-strip></oj-bind-if> 標記。

            </oj-film-strip>
         </div>
      </div>
      </oj-bind-if>
    
  19. 在關閉的 </div></oj-bind-if> 標記之間新增分頁控制項和周圍 div 元素。

            </oj-film-strip>
         </div>
      </div>
      <div class="oj-flex oj-sm-flex-items-initial oj-sm-justify-content-center">
         <div class="oj-flex-item">
            <div style="text-align: center;">
            <div style="display: inline-block;margin-top: 4px;">
               <oj-paging-control id="pagingControl"
                  aria-controls="deptFilmstrip"
                  data="[[pagingModel]]"
                  page-size="0"
                  page-options='{"type": "dots"}'>
               </oj-paging-control>
            </div>
            </div>
         </div>
      </div>
      </oj-bind-if>
    
  20. 儲存檔案。您的檔案看起來類似於 departments-html.txt

  21. 重新執行螢幕助讀程式驗證。確保在影片、資料方格和圖表中朗讀標籤,並在影片片段下方顯示分頁控制項。

下一步

本教學課程總結了 Web 應用程式輔助功能上此學習路徑中的驗證並修正應用程式輔助功能模組。

您可以返回輔助功能學習路徑的主頁面,以存取輔助功能的所有模組,以及其他學習路徑。

其他學習資源

docs.oracle.com/learn 上探索其他實驗室,或在 Oracle Learning YouTube 頻道上存取更多免費學習內容。此外,請造訪 education.oracle.com/learning-explorer 以成為 Oracle Learning Explorer。

如需產品文件,請造訪 Oracle Help Center