Katıştırılmış çözümünüz için erişilebilirlik

Power BI ile çalışırken, eklenmiş raporlarınızı etkileşim kurabilecek farklı kullanıcı türleri için erişilebilir hale getirebilirsiniz. Raporlarınızı daha erişilebilir hale getirmenin birkaç kolay yolu, title ve tabindex özniteliklerini, klavye kısayollarını ve yüksek karşıtlık modunu kullanmaktır.

Title ve tabindex özniteliklerini kullanma

powerbi.embed veya powerbi.bootstrap yöntemini çağırdıktan sonra, eklediğiniz türün bir bileşenini alırsınız.

Başlık özniteliği

title özniteliği, ait olduğu öğeye metin eklemenize olanak tanır. Birisi ekran okuyucu kullanıyorsa, öğe hakkındaki ek bilgileri okur. Ekleme bileşeninin title özniteliğini ayarlamak için setComponentTitlekullanın.

setComponentTitle(title: string): void

Başlık özniteliği örneği

let component = powerbi.embed(…);
component.setComponentTitle(“Analytics report”);

title özniteliği hakkında daha fazla bilgi edinmek için MDN Web Docsbaşlığı makalesine bakın.

Tabindex özniteliği

Kişiler, eklenmiş raporlarınızda gezinmek için klavyelerini kullanabilir. tabindex özniteliğini kullanarak, raporunuzda kullanıcı Sekmebastığında atlanacak öğelere sekmeli odak ekleyebilirsiniz. Ekleme bileşeninin tabindex özniteliğini ayarlamak için setComponentTabIndexkullanın.

setComponentTabIndex(tabIndex?: number): void

removeComponentTabIndex kullanarak tabindex özniteliğini kaldırabilirsiniz

removeComponentTabIndex(tabIndex?: number): void

Tabindex özniteliği örneği

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

tabindex özniteliği hakkında daha fazla bilgi edinmek için MDN Web Docstabindex makalesine bakın.

Katıştırılmış Power BI raporlarında klavye kısayolları

Klavyelerini kullanarak ekli raporlarınızı keşfeden kişiler için klavye kısayollarının listesi çok değerli bir araçtır. Klavye kısayollarını göstermek isterseniz, eklenmiş rapora odaklanın ve Shift? basın..

Daha fazla bilgi edinmek için bkz. Power BI Desktopklavye kısayolları.

Eklenmiş Power BI raporlarında yüksek karşıtlık modu

Görsel veya fiziksel engelli kullanıcıların ekli raporlarınızdan yararlanmasına yardımcı olmak için bunları yüksek karşıtlık teması kullanacak şekilde ayarlayabilirsiniz.

Uygulamanızın ekleme yapılandırmasına tek bir parametre ekleyerek yüksek karşıtlık modunu ayarlayabilirsiniz.

let embedConfig = {
    …
    contrastMode: models.ContrastMode.HighContrast1
};

Kullanılabilir karşıtlık modları şunlardır:

enum ContrastMode {
    None = 0,
    HighContrast1 = 1,
    HighContrast2 = 2,
    HighContrastBlack = 3,
    HighContrastWhite = 4
}

Varsayılan değer None = 0.

Önemli

Hem yüksek karşıtlık modu hem de tema sağlarsanız Power BI yalnızca yüksek karşıtlık modunu uygular. Her ikisi de aynı anda uygulanamaz.

Power BI raporları için yakınlaştırma düzeyini ayarlama

Görsel veya fiziksel engelli kullanıcıların eklenmiş raporlarınızdan yararlanmasına yardımcı olmak için rapor yakınlaştırma düzeyini varsayılan düzeyden daha yüksek veya daha düşük olacak şekilde ayarlayabilirsiniz.

Ekleme ayarlarına tek bir parametre ekleyerek veya rapor yükledikten sonra setZoom API'sini kullanarak raporun yakınlaştırma düzeyini ayarlayabilirsiniz.

Yakınlaştırma düzeyi, raporun gerçek boyutuna göre hesaplanır. Rapor görüntüleme seçenekleri hakkında daha fazla bilgi edinmek için bkz. Rapor sayfasının görünümünü değiştirme.

let embedConfig = {
    …
    settings: {
        zoomLevel: 2 // 200% zoom
    }
};

Geçerli yakınlaştırma düzeyini almak veya rapor yüklendikten sonra değiştirmek için getZoom ve setZoom API'lerini kullanabilirsiniz.

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

Not

Yakınlaştırma düzeyi 0,25 (25%) ile dört (400%) arasında olmalıdır.