支援自訂視覺效果中的鍵盤瀏覽
本文會說明如何支援使用鍵盤瀏覽 Power BI 視覺效果。 鍵盤瀏覽可讓身心障礙人士更容易存取 Power BI,並提供更多選項來與報表互動。
supportsKeyboardFocus
功能可讓您只使用鍵盤就能瀏覽視覺效果的資料點。
基本鍵盤協助工具功能
所有視覺效果都隨附下列基本鍵盤協助工具功能:
- 按 [Esc] 以將焦點從視覺效果內部移至視覺容器。
- 從自訂視覺效果內部按 [Tab] 以瀏覽視覺效果中的可索引標籤元素。 在最後一個可索引標籤元素之後按下 [Tab],會將焦點移回視覺效果外部。
加强的鍵盤協助工具
若要讓您的自訂視覺效果更容易存取,請將下列行新增至「capabilities.json」檔案,將 supportsKeyboardFocus
功能新增至視覺效果:
{
...
"supportsKeyboardFocus": true
...
}
此功能會將下列功能新增至您的自訂視覺效果:
- 當焦點位於視覺容器上時按 [Enter],會將焦點移至自訂視覺效果內部。
- 從自訂視覺效果內部按 [Tab] 以瀏覽可索引標籤元素。 焦點會保留在視覺效果內,直到您按下 [Esc] 為止。
注意
並非所有 HTML 元素預設都是可索引標籤的 (例如 div 和 span)。 請考慮將正確的屬性 (例如 tabindex) 新增至這些元素,使其成為可索引標籤。
考量與限制
此功能需要 API 2.1.0 版或更高版本。
此功能無法套用至影像視覺效果。
按下視覺效果容器上的 [Enter] 不一定會落在視覺效果的第一個可焦點元素上。 若要確定從第一個元素開始,請在焦點進入視覺效果之後,以程式設計方式將焦點放在視覺效果中。
在視覺容器上按下 [Enter] 並在最後一個可設定焦點的元素上按 [Tab] 之後,使用者可能必須按 [Tab] 多次,才能進入第一個元素。