포함된 솔루션에 대한 접근성
Power BI로 작업할 때 포함된 보고서를 상호 작용할 수 있는 다양한 유형의 사용자가 액세스할 수 있도록 하는 것이 좋습니다. 보고서에 더 쉽게 액세스할 수 있는 몇 가지 방법은 및 tabindex
특성, 바로 가기 키 및 고대비 모드를 사용하는 title
것입니다.
제목 및 tabindex 특성을 사용하는 방법
또는 메서드를 powerbi.embed
powerbi.bootstrap
호출한 후 포함된 형식의 구성 요소를 가져옵니다.
Title 특성
title
특성을 사용하면 해당 특성이 속한 요소에 텍스트를 추가할 수 있습니다. 누군가가 화면 읽기 프로그램을 사용하는 경우 해당 요소에 대한 추가 정보를 읽습니다. 포함 구성 요소의 title
특성을 설정하려면 를 사용합니다 setComponentTitle
.
setComponentTitle(title: string): void
Title 특성 예제
let component = powerbi.embed(…);
component.setComponentTitle(“Analytics report”);
특성에 title
대한 자세한 내용은 MDN 웹 문서제목 문서를 참조하세요.
Tabindex 특성
사람 키보드를 사용하여 포함된 보고서를 탐색할 수 있습니다. 특성을 사용하여 tabindex
사용자가 Tab 키를 누를 때 건너뛸 수 있는 탭 포커스를 보고서의 요소에 추가할 수 있습니다. 포함 구성 요소의 tabindex
특성을 설정하려면 를 사용합니다 setComponentTabIndex
.
setComponentTabIndex(tabIndex?: number): void
을 tabindex
사용하여 특성을 제거할 수 있습니다. removeComponentTabIndex
removeComponentTabIndex(tabIndex?: number): void
Tabindex 특성 예제
let component = powerbi.embed(...);
component.setComponentTabIndex(0);
특성에 tabindex
대한 자세한 내용은 MDN Web Docstabindex 문서를 참조하세요.
포함된 Power BI 보고서의 바로 가기 키
키보드를 사용하여 포함된 보고서를 탐색하는 사람들에게 바로 가기 키 목록은 매우 중요한 도구입니다. 바로 가기 키를 표시하려면 포함된 보고서에 집중하고 Shift+키를 누릅니다.
자세한 내용은 Power BI Desktop 바로 가기 키를 참조하세요.
포함된 Power BI 보고서의 고대비 모드
시각 또는 신체 장애가 있는 사용자가 포함된 보고서의 이점을 누릴 수 있도록 고대비 테마를 사용하도록 설정할 수 있습니다.
애플리케이션의 포함 구성에 단일 매개 변수를 추가하여 고대비 모드를 설정할 수 있습니다.
let embedConfig = {
…
contrastMode: models.ContrastMode.HighContrast1
};
사용 가능한 대비 모드는 다음과 같습니다.
enum ContrastMode {
None = 0,
HighContrast1 = 1,
HighContrast2 = 2,
HighContrastBlack = 3,
HighContrastWhite = 4
}
기본값은 None = 0
입니다.
중요
고대비 모드와 테마를 모두 제공하는 경우 Power BI는 고대비 모드만 적용합니다. 둘 다 동시에 적용할 수 없습니다.
Power BI 보고서의 확대/축소 수준 조정
시각 또는 신체 장애가 있는 사용자가 포함된 보고서의 이점을 누릴 수 있도록 보고서 확대/축소 수준을 기본 수준보다 높거나 낮게 조정할 수 있습니다.
포함 설정에 단일 매개 변수를 추가하거나 보고서가 로드된 후 API를 사용하여 setZoom
보고서의 확대/축소 수준을 설정할 수 있습니다.
확대/축소 수준은 보고서의 실제 크기에 따라 계산됩니다. 보고서 표시 옵션에 대한 자세한 내용은 보고서 페이지 표시 변경을 참조하세요.
let embedConfig = {
…
settings: {
zoomLevel: 2 // 200% zoom
}
};
현재 확대/축소 수준을 얻거나 보고서가 로드된 후 변경하려면 및 setZoom
API를 getZoom
사용할 수 있습니다.
let currentZoom = await report.getZoom();
await report.setZoom(0.5); // 50% zoom
참고
확대/축소 수준은 0.25(25%)에서 4(400%) 사이여야 합니다.