Interações visuais em visuais do Power BI

Às vezes, você deseja permitir que o usuário interaja com o visual selecionando-o, ampliando-o ou clicando nele. Outras vezes você deseja que o visual seja estático para que o usuário não possa interagir com ele.

Os visuais podem consultar o valor do sinalizador allowInteractions, que indica se o visual permite interações visuais. Por exemplo, os visuais podem ser interativos durante a exibição ou a edição do relatório, mas podem ser não interativos quando exibidos em um dashboard. Essas interações incluem clique, panorâmica, zoom, seleção e outras.

Observação

A melhor prática é habilitar as dicas de ferramentas em todos os cenários, independentemente do sinalizador indicado.

Definir permissões interativas

O sinalizador allowInteractions é passado como um valor booliano durante a inicialização do visual, como membro da interface IVisualHost.

Em qualquer cenário do Power BI que exija visuais não interativos (por exemplo, blocos de dashboard), defina o sinalizador allowInteractions como false. Caso contrário (por exemplo, Relatório), defina allowInteractions como true.

O exemplo de código a seguir mostra como usar o sinalizador allowInteractions para definir permissões interativas.

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

Para obter mais informações sobre como usar o sinalizador allowInteractions, consulte o repositório visual SampleBarChart.

Conteúdo relacionado

API do Visual