Ułatwienia dostępu dla rozwiązania osadzonego
Podczas pracy z usługą Power BI rozważ udostępnienie osadzonych raportów różnym typom użytkowników, którzy mogą z nimi korzystać. Kilka prostych sposobów na zwiększenie dostępności raportów polega na użyciu atrybutów title i tabindex, skrótów klawiaturowych i trybu dużego kontrastu.
Jak używać atrybutów tytułu i tabindex
Po wywołaniu powerbi.embed lub metody powerbi.bootstrap uzyskasz składnik typu osadzonego.
Atrybut tytułu
Atrybut title umożliwia dodawanie tekstu do elementu, do którego należy. Jeśli ktoś korzysta z czytnika zawartości ekranu, odczytuje dodatkowe informacje o elemecie. Aby ustawić atrybut title składnika osadzania, użyj setComponentTitle.
setComponentTitle(title: string): void
Przykład atrybutu tytułu
let component = powerbi.embed(…);
component.setComponentTitle(“Analytics report”);
Aby dowiedzieć się więcej o atrybucie title, zobacz artykuł Web DocsmdN tytuł.
Atrybut Tabindex
Użytkownicy mogą używać klawiatury do nawigowania po osadzonych raportach. Możesz użyć atrybutu tabindex, aby dodać fokus z kartami do elementów w raporcie, które w przeciwnym razie zostaną pominięte, gdy użytkownik naciśnie kartę . Aby ustawić atrybut tabindex składnika osadzania, użyj setComponentTabIndex.
setComponentTabIndex(tabIndex?: number): void
Atrybut tabindex można usunąć przy użyciu removeComponentTabIndex
removeComponentTabIndex(tabIndex?: number): void
Przykład atrybutu Tabindex
let component = powerbi.embed(...);
component.setComponentTabIndex(0);
Aby dowiedzieć się więcej o atrybucie tabindex, zobacz artykuł Web Docstabindex MDN Web Docs.
Skróty klawiaturowe w osadzonych raportach usługi Power BI
Dla osób, które używają klawiatur do eksplorowania osadzonych raportów, lista skrótów klawiaturowych jest nieocenionym narzędziem. Jeśli chcesz wyświetlić skróty klawiaturowe, skoncentruj się na osadzonym raporcie i naciśnij Shift+?.
Aby dowiedzieć się więcej, zobacz skróty klawiaturowe w programie Power BI Desktop.
Tryb dużego kontrastu w osadzonych raportach usługi Power BI
Aby ułatwić użytkownikom niedowidzących lub fizycznych korzyści z osadzonych raportów, można ustawić je tak, aby korzystały z motywu o wysokim kontraście.
Tryb dużego kontrastu można ustawić, dodając pojedynczy parametr do konfiguracji osadzania aplikacji.
let embedConfig = {
…
contrastMode: models.ContrastMode.HighContrast1
};
Dostępne tryby kontrastu to:
enum ContrastMode {
None = 0,
HighContrast1 = 1,
HighContrast2 = 2,
HighContrastBlack = 3,
HighContrastWhite = 4
}
Wartość domyślna to None = 0.
Ważny
Jeśli podasz zarówno tryb dużego kontrastu, jak i motyw, usługa Power BI zastosuje tylko tryb dużego kontrastu. Nie można zastosować obu w tym samym czasie.
Dostosowywanie poziomu powiększenia dla raportów usługi Power BI
Aby pomóc użytkownikom z upośledzeniem wzrokowym lub fizycznym korzystać z osadzonych raportów, możesz dostosować poziom powiększenia raportu, aby był wyższy lub niższy niż domyślny poziom.
Poziom powiększenia raportu można ustawić, dodając pojedynczy parametr do ustawień osadzania lub używając interfejsu API setZoom po załadowaniu raportu.
Poziom powiększenia jest obliczany na podstawie rzeczywistego rozmiaru raportu. Zobacz Zmienianie wyświetlania strony raportu, aby dowiedzieć się więcej o opcjach wyświetlania raportu.
let embedConfig = {
…
settings: {
zoomLevel: 2 // 200% zoom
}
};
Aby uzyskać bieżący poziom powiększenia lub zmienić go po załadowaniu raportu, możesz użyć interfejsów API getZoom i setZoom.
let currentZoom = await report.getZoom();
await report.setZoom(0.5); // 50% zoom
Nuta
Poziom powiększenia musi należeć do zakresu od 0,25 (25%) do czterech (400%).