Partilhar via


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 atributos title e tabindex, atalhos de teclado e modo de alto contraste.

Como usar atributos de título e tabindex

Depois de chamar o powerbi.embed ou o método powerbi.bootstrap, você obtém um componente do tipo inserido.

Atributo de título

O atributo title 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 atributo title 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 atributo title, consulte o artigo títulodo MDN Web Docs artigo.

Atributo Tabindex

As pessoas podem usar o teclado para navegar pelos relatórios inseridos. Você pode usar o atributo tabindex 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 atributo tabindex do componente de inserção, use setComponentTabIndex.

setComponentTabIndex(tabIndex?: number): void

Você pode remover o atributo tabindex usando removeComponentTabIndex

removeComponentTabIndex(tabIndex?: number): void

Exemplo de atributo Tabindex

let component = powerbi.embed(...);
component.setComponentTabIndex(0);

Para saber mais sobre o atributo tabindex, consulte o artigo MDN Web Docstabindex.

Atalhos de teclado em relatórios inseridos do Power BI

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, consulte 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 API setZoom 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 tiver carregado, você pode usar as APIs getZoom e setZoom.

let currentZoom = await report.getZoom();
await report.setZoom(0.5); // 50% zoom

Nota

O nível de zoom deve estar entre 0,25 (25%) e quatro (400%).