Introdução
Instalação
Guias
- Engine
- Profile
- Browser
- BrowserView
- Navegação
- Conteúdo
- DOM
- JavaScript
- Pop-ups
- Diálogos
- Downloads
- Extensões
- Rede
- Cache
- Cookies
- Proxy
- Autenticação
- Plugins
- Impressão
- Senhas
- Perfis de dados do Usuário
- Cartões de Crédito
- Mídia
- Área de transferência
- Zoom
- Corretor Ortográfico
- Implantação
- Chromium
Resolução de Problemas
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:
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%:
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:
zoom.in();
zoom.in()
Reduzir o Zoom
Para aumentar o zoom numa página Web atualmente carregada, utilize o seguinte método:
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%:
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:
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:
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:
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.