建置無障礙應用程式

發行項
04/25/2024

超過 20% 的網際網路使用者需要無障礙的 Web 應用程式。因此，請務必確定已將您的應用程式設計成可讓任何使用者輕鬆地加以使用。您不需要將協助工具視為一組要完成的工作，而是將其視為整體使用者體驗的一部分。您的應用程式越容易存取，使用的人數就越多。

若應用程式會提供地圖之類的豐富互動式內容，則以下是一些常見的協助工具考慮事項：

為對於看到 Web 應用程式有困難的使用者提供螢幕助讀程式的支援。
有多種方法可以與 Web 應用程式進行互動和瀏覽，例如滑鼠、觸控和鍵盤。
確保色彩對比不會讓色彩混合在一起，因而變得難以區分。

Azure 地圖服務 Web SDK 預先建置了協助工具功能，例如：

螢幕助讀程式會在地圖移動時，以及當使用者的焦點位於控制項或快顯時提供描述。
滑鼠、觸控和鍵盤支援。
道路地圖樣式中支援可存取的色彩對比。
支援高對比。

如需所有 Microsoft 產品的完整協助工具符合性詳細資料，請參閱輔助功能一致性報告。搜尋「Azure 地圖服務 Web」，以尋找專為 Azure 地圖服務 Web SDK 提供的文件。

瀏覽地圖

有數種不同方式可用來對地圖進行縮放、移動瀏覽、旋轉及調整傾斜度。以下將詳細說明瀏覽地圖的各種不同方式。

縮放地圖

使用滑鼠，按兩下地圖即可放大一個等級。
使用滑鼠，捲動滾輪來縮放地圖。
使用觸控式螢幕，以兩支手指接觸地圖，捏合即可縮小，張開手指即可放大。
使用觸控式螢幕，點兩下地圖即可放大一個等級。
將焦點放在地圖上，使用加號 (+) 或等號 (=) 來放大一個等級。
將焦點放在地圖上，使用減號 (-) 或底線 (_) 來縮小一個等級。
使用縮放控制項並搭配滑鼠、觸控或鍵盤 Tab/Enter 鍵。
按住 Shift 按鈕並在地圖上按下滑鼠左鍵，然後拖曳來繪製一個區域，以將地圖縮放至其中。
使用一些多點觸控板，將兩指向上拖曳以縮小，或向下拖曳以放大。

移動瀏覽地圖

使用滑鼠、在地圖上按下滑鼠左鍵，然後以任何方向拖曳。
使用觸控式螢幕，觸控地圖，然後以任何方向拖曳。
將焦點放在地圖上，使用方向鍵來移動地圖。

旋轉地圖

使用滑鼠、在地圖上按下滑鼠右鍵，然後向左或向右拖曳。
使用觸控式螢幕，以兩支手指觸控地圖並旋轉。
將焦點放在地圖上，使用 Shift 鍵和向左鍵或向右鍵。
使用旋轉控制項並搭配滑鼠、觸控或鍵盤 Tab/Enter 鍵。

調整地圖傾斜度

使用滑鼠、在地圖上按下滑鼠右鍵，然後向上或向下拖曳。
使用觸控式螢幕，以兩支手指觸控地圖，然後將其一起向上或向下拖曳。
將焦點放在地圖上，使用 Shift 鍵加上向上鍵或向下鍵。
使用調整傾斜度控制項並搭配滑鼠、觸控或鍵盤 Tab/Enter 鍵。

變更地圖樣式

並非所有開發人員都想要在其應用程式中提供所有可能的地圖樣式。如果開發人員顯示地圖的樣式選擇器控制項，則使用者可以使用滑鼠、觸控或鍵盤 (搭配 Tab 或 Enter 鍵) 來變更地圖樣式。開發人員可以指定其想要在地圖樣式選擇器控制項中使用的地圖樣式。此外，開發人員也可以透過程式設計方式來設定和變更地圖樣式。

使用高對比

載入地圖控制項時，其會檢查以查看是否已啟用高對比，且瀏覽器是否支援。
地圖控制項不會監視裝置的高對比模式。如果裝置模式變更，地圖將不會變更。因此，使用者需要重新整理頁面，以便重新載入地圖。
偵測到高對比時，地圖樣式會自動切換為高對比，而所有內建控制項都將使用高對比樣式。例如，ZoomControl、PitchControl、CompassControl、StyleControl 和其他內建控制項都將使用高對比樣式。
高對比有兩種類型：淺色和深色。如果地圖控制項可以偵測到高對比的類型，則地圖的行為會據以調整。若為淺色，即載入 grayscale_light 地圖樣式。如果無法偵測到類型或其為深色，則載入 high_contrast_dark 樣式。
如果要建立自訂控制項，那麼，知道內建控制項是否正在使用高對比樣式就很實用。開發人員可以在要檢查的地圖容器 div 上新增 CSS 類別。要新增的 CSS 類別是 high-contrast-dark 和 high-contrast-light。若要使用 JavaScript 進行檢查，請使用：

map.getMapContainer().classList.contains("high-contrast-dark")

或者，使用：

map.getMapContainer().classList.contains("high-contrast-light")

鍵盤快速鍵

地圖中有內建的鍵盤快速鍵，讓您能夠更輕鬆地使用地圖。當地圖具有焦點時，這些鍵盤快速鍵就會運作。

機碼	動作
`Tab`	瀏覽地圖中的各個控制項和快顯。
`ESC`	將焦點從地圖中的任意元素移至最上層地圖元素。
`Ctrl` + `Shift` + `D`	切換螢幕助讀程式詳細等級。
向左鍵	將地圖向左移動瀏覽 100 個像素
向右鍵	將地圖向右移動瀏覽 100 個像素
向下鍵	將地圖向下移動瀏覽 100 個像素
向上鍵	將地圖向上移動瀏覽 100 個像素
`Shift` + 向上鍵	將地圖傾斜度調高 10 度
`Shift` + 向下鍵	將地圖傾斜度降低 10 度
`Shift` + 向右鍵	將地圖順時針旋轉 15 度
`Shift` + 向左鍵	將地圖逆時針旋轉 15 度
加號 (`+`) 或 ^*等號 (`=`)	放大
減號、連字號 (`-`) 或 ^*底線 (`_`)	縮小
`Shift` + 在地圖上拖曳滑鼠以繪製區域	放大區域

^* 這些按鍵快速鍵通常會共用鍵盤上的相同按鍵。這些快速鍵已新增來改善使用者體驗。不論使用者是否會針對這些快速鍵使用 Shift 鍵，也都不會有任何影響。

使用者可以使用鍵盤瀏覽地圖。如果螢幕助讀程式正在執行，地圖會通知使用者其狀態的變更。例如，使用者在移動瀏覽或縮放地圖時，會收到地圖變更的通知。根據預設，地圖會提供簡化的描述，以排除地圖中心的縮放等級和座標。使用者可以使用鍵盤快速鍵 Ctrl + Shift + D，來切換這些描述的詳細等級。

放在底圖上的任何其他資訊都應該具有適用於螢幕助讀程式使用者的對應文字資訊。請務必在適當的情況下，新增無障礙豐富網際網路應用程式 (ARIA) \(英文\)、alt 與 title 屬性。

讓快顯鍵盤可供存取

通常會使用標記或符號來代表地圖上的位置。當使用者與標記互動時，關於此位置的其他資訊通常會顯示在快顯中。在大部分的應用程式中，當使用者選取標記時，即會出現快顯。不過，按一下和點選需要使用者分別使用滑鼠和觸控式螢幕。最佳做法是在使用鍵盤時讓快顯可供存取。此功能可以藉由建立每個資料點的快顯，並將其新增到地圖來實現。

可存取的彈出視窗範例會使用符號圖層，在地圖上載入感興趣的點，並針對每個興趣點，在地圖上新增一個快顯。每個快顯的參考都會儲存於每個資料點的屬性中。您也可以針對某個標記進行擷取，例如，選取標記時。當焦點在地圖上時，按 Tab 鍵可讓使用者逐步瀏覽地圖上的每個快顯。如需此範例的原始程式碼，請參閱可存取的彈出視窗原始程式碼。

顯示具有可存取彈出視窗之地圖的螢幕擷取畫面。