Acessibilidade para sua solução inserida
Ao trabalhar com o Power BI, considere tornar seus relatórios inseridos acessíveis a diferentes tipos de usuários que podem interagir com eles. Algumas maneiras fáceis de tornar seus relatórios mais acessíveis é usar os title
atributos e tabindex
, atalhos de teclado e modo de alto contraste.
Como usar atributos de título e tabindex
Depois de chamar o powerbi.embed
método ou powerbi.bootstrap
, você obtém um componente do tipo inserido.
Atributo de título
O title
atributo permite adicionar texto ao elemento ao qual ele pertence. Se alguém estiver usando um leitor de tela, ele lerá as informações adicionais sobre o elemento para ele. Para definir o title
atributo do componente de inserção, use setComponentTitle
.
setComponentTitle(title: string): void
Exemplo de atributo de título
let component = powerbi.embed(…);
component.setComponentTitle(“Analytics report”);
Para saber mais sobre o title
atributo, consulte o artigo Título do MDN Web Docs.
Atributo Tabindex
Pessoas pode usar o teclado para navegar pelos relatórios inseridos. Você pode usar o tabindex
atributo para adicionar foco com guias a elementos em seu relatório que, de outra forma, seriam ignorados quando o usuário pressionaSse Tab. Para definir o tabindex
atributo do componente de inserção, use setComponentTabIndex
.
setComponentTabIndex(tabIndex?: number): void
Você pode remover o tabindex
atributo usando removeComponentTabIndex
removeComponentTabIndex(tabIndex?: number): void
Exemplo de atributo Tabindex
let component = powerbi.embed(...);
component.setComponentTabIndex(0);
Para saber mais sobre o tabindex
atributo, consulte o artigo tabindex do MDN Web Docs.
Atalhos de teclado em relatórios do Power BI inseridos
Para as pessoas que usam seus teclados para explorar seus relatórios inseridos, uma lista de atalhos de teclado é uma ferramenta inestimável. Se você quiser mostrar os atalhos de teclado, concentre-se no relatório inserido e pressione Shift+?.
Para saber mais, confira Atalhos de teclado no Power BI Desktop.
Modo de alto contraste em relatórios do Power BI inseridos
Para ajudar os usuários com deficiências visuais ou físicas a se beneficiarem de seus relatórios inseridos, você pode defini-los para usar um tema de alto contraste.
Você pode definir o modo de alto contraste adicionando um único parâmetro à configuração de inserção do aplicativo.
let embedConfig = {
…
contrastMode: models.ContrastMode.HighContrast1
};
Os modos de contraste disponíveis são:
enum ContrastMode {
None = 0,
HighContrast1 = 1,
HighContrast2 = 2,
HighContrastBlack = 3,
HighContrastWhite = 4
}
O padrão é None = 0
.
Importante
Se você fornecer um modo de alto contraste e um tema, o Power BI aplicará apenas o modo de alto contraste. Ele não pode aplicar ambos ao mesmo tempo.
Ajustar o nível de zoom para relatórios do Power BI
Para ajudar os usuários com deficiências visuais ou físicas a se beneficiarem de seus relatórios inseridos, você pode ajustar o nível de zoom do relatório para ser maior ou menor do que o nível padrão.
Você pode definir o nível de zoom do relatório adicionando um único parâmetro às configurações de inserção ou usando a setZoom
API após o carregamento do relatório.
O nível de zoom é calculado com base no tamanho real do relatório. Consulte Alterar a exibição de uma página de relatório para saber mais sobre as opções de exibição do relatório.
let embedConfig = {
…
settings: {
zoomLevel: 2 // 200% zoom
}
};
Para obter o nível de zoom atual ou alterá-lo depois que o relatório for carregado, você pode usar as getZoom
APIs e setZoom
.
let currentZoom = await report.getZoom();
await report.setZoom(0.5); // 50% zoom
Observação
O nível de zoom deve estar entre 0,25 (25%) e quatro (400%).