List icon Conteúdo

Zoom

Este guia mostra como trabalhar com a API de Zoom.

O JxBrowser permite ampliar o conteúdo de uma página Web ou de todas as páginas Web, receber notificações quando o nível de zoom de uma página Web tiver sido alterado, substituir o nível de zoom padrão, etc.

Para trabalhar com o zoom global que será aplicado a todas as páginas da web, utilize a classe ZoomLevels. Uma instância desta classe que pode ser obtida a partir de Profile. Por exemplo:

Java
Kotlin
ZoomLevels zoomLevels = profile.zoomLevels();
val zoomLevels = profile.zoomLevels()

Se você utilizar Engine.zoomLevels() então obterá a instância ZoomLevels associada ao perfil padrão.

Para controlar o zoom de uma página web carregada em uma instância do Browser utilize a classe Zoom.

Nível de Zoom Padrão

O nível de zoom padrão para todas as páginas Web é de 100%. Para alterar o nível de zoom padrão, utilize o método ZoomLevels.defaultLevel(ZoomLevel).

O código seguinte define o nível de zoom padrão para todas as páginas Web como 150%:

Java
Kotlin
zoomLevels.defaultLevel(ZoomLevel.P_150);
zoomLevels.defaultLevel(ZoomLevel.P_150)

Controlando o Zoom

É possível ampliar o conteúdo de uma página web carregada no Browser programaticamente utilizando a classe Zoom ou utilizando gestos de toque em ambientes com tela tátil.

O nível de zoom é configurado separadamente para cada anfitrião. Se definir um nível de zoom para a página Web http://www.a.com, este não será alterado para a página Web http://www.b.com.

Para alterar o nível de zoom, é necessário aguardar até a página Web estar completamente carregada.

Ampliar

Para ampliar o zoom de uma página Web atualmente carregada, utilize o seguinte método:

Java
Kotlin
zoom.in();
zoom.in()

Reduzir o Zoom

Para aumentar o zoom numa página Web atualmente carregada, utilize o seguinte método:

Java
Kotlin
zoom.out();
zoom.out()

Definir o Nível de Zoom

O código seguinte define o nível de zoom da página Web carregada para 200%:

Java
Kotlin
zoom.level(ZoomLevel.P_200);
zoom.level(ZoomLevel.P_200)

Resetando o Zoom

Para resetar o nível de zoom para o valor padrão utilize o seguinte código:

Java
Kotlin
zoom.reset();
zoom.reset()

Desativar o Zoom

Você pode desabilitar o zoom para todas as páginas web carregadas em um Browser utilizando o método Zoom.disable(). Este método desativa a funcionalidade de zoom e reseta o nível de zoom no valor padrão. Depois disso, todas as tentativas de alterar o nível de zoom de forma programática através da API de zoom do JxBrowser e utilizando gestos táteis num dispositivo de tela tátil serão ignoradas.

Por exemplo:

Java
Kotlin
zoom.disable();
zoom.disable()

Eventos de Zoom

Para receber notificações quando o nível de zoom de uma determinada página da Web tiver sido alterado, use o evento ZoomLevelChanged. Por exemplo:

Java
Kotlin
zoomLevels.on(ZoomLevelChanged.class, event -> {
    Host host = event.host();
    ZoomLevel zoomLevel = event.level();
});
zoomLevels.on(ZoomLevelChanged::class.java) { event ->
    val host = event.host()
    val zoomLevel = event.level()
}

Pinch para Ampliar

Atualmente, o JxBrowser não suporta o zoom através de um gesto de pinch-to-zoom do trackpad no macOS.