共用方式為


Power BI 視覺效果中的視覺效果互動

有時候您想要讓使用者透過選取、縮放或按一下視覺效果來與視覺效果互動。 其他時候,您想要視覺效果是靜態的,讓使用者無法與視覺效果互動。

視覺效果可以查詢 allowInteractions 標幟的值,這個值指出視覺效果是否允許視覺效果互動。 例如,視覺效果可以在報表檢視或編輯期間是可以互動的,但在儀表板中檢閱時視覺效果可以設為非互動式的。 這些互動包括 [按一下]、[移動瀏覽]、[縮放]、[選取]等。

注意

最佳做法是,無論指示哪一個旗標,在所有情況下,您都應該啟用工具提示

設定互動權限

allowInteractions 旗標會在視覺效果初始化期間以布林值形式傳遞,作為 IVisualHost 介面的成員。

在需要非互動式視覺效果的任何 Power BI 案例中 (例如,儀表板圖格),allowInteractions 旗標會設定為 false。 否則 (例如,報表),allowInteractions 會設定為 true

下列範例程式碼示範如何使用 allowInteractions 旗標來設定互動權限。

   ...
   let allowInteractions = options.host.hostCapabilities.allowInteractions;
   bars.on('click', function(d) {
       if (allowInteractions) {
           selectionManager.select(d.selectionId);
           ...
       }
   });

如需更多有關 allowInteractions 旗標的詳細資訊,請參閱 SampleBarChart 視覺效果存放庫

視覺效果 API