共用方式為


支援自訂視覺效果中的鍵盤瀏覽

本文會說明如何支援使用鍵盤瀏覽 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] 多次,才能進入第一個元素。