Área Web

As áreas web podem mostrar todo tipo de conteúdo web ao interior de seus formulários: as páginas HTML com conteúdo estático ou dinâmico contém arquivos, imagens, Javascript, Flash, PDF (1)... ou até mesmo documentos MS Office (em Windows, com MS Office instalado).

Várias ações padrão,numerosos comandos de linguagem e eventos de formulário permitem ao desenvolvedor controlar o funcionamento das áreas web. As variáveis específicas permitem trocar informação entre a área e o ambiente 4D.

Quando um objeto de área de web é selecionado no editor de formulário, a lista de propriedades mostra as seguintes propriedades específicas:

Quando é selecionada a propriedade Menu contextual para uma área de web tema "Entrada", o usuário pode acessar um menu contextual padrão na área durante a execução do formulário.

O conteúdo do menu está definido pelo motor de renderização da plataforma: WebKit de Apple (renderização do navegador Safari) com Mac OS e ActiveX Web (renderização do navegador Internet Explorer) com Windows.

Nota É possível controlar o acesso ao menu contextual através do comando WA SET PREFERENCE.

Duas variáveis específicas estão automaticamente associadas a cada área de web: “URL” e “Progressão.” Estas variáveis permitem controlar respectivamente o URL mostrado pela área de web e a porcentagem de carregamento da página mostrada na área de web. Por padrão, estas variáveis chamam-se, respectivamente, nomeArea_url e nomeArea_progress. É possível alterar estes nomes se preferir.

Estas variáveis são definidas na Lista de propriedades quando uma área de web está selecionada:

Para maiores informações sobre o funcionamento destas variáveis, consulte a seção Gestão programada de áreas web no manual de Linguagem 4D.

Pode utilizar esta opção para escolher entre dois motores de renderização para a área web, em função das especificações de sua aplicação:

• "Utilizar Web Kit integrado" sem selecionar (por padrão): neste caso, 4D utiliza o "melhor" motor correspondente ao sistema. Em Windows, 4D utiliza automaticamente a versão mais recente do navegador Internet Explorer presente na máquina (IE9, IE10, etc.) Em Mac OS, 4D utiliza a versão atual do Web Kit (Safari).
  Este funcionamento permite ser beneficiado automaticamente dos últimos avances em renderização web, através de HTML 5 ou JavaScript. Entretanto, é possível que observe algumas diferenças de renderização entre as implementações de Internet Explorer e de Web Kit.

• "Utilizar Web kit integrado" selecionado: neste caso, 4D utiliza Web Kit em versões 32 bits e Blink (preview) em versões 64 bits. O uso do Web Kit integrado significa que a renderização da área web e seu funcionamento em sua aplicação são idênticos, independentemente da plataforma utilizada para executar 4D (no entanto, podem apresentar-se pequenas variações de píxels ou diferenças relacionadas com a implementação da rede).
  Quando esta opção é escolhida, você já não se beneficia das atualizações automáticas do motor Web efetuadas pelo sistema operativo; no entanto, as novas versões do WebKit são oferecidas via 4D.

Usar WebKit (motor Web embebido de renderização em  4D 32-bit):

WebKit é uma motor de renderização multi-plataforma open source. Também é usado por Safari, entre outros. Quando o motor de renderização Web kit integrado for usado, note os detalhes abaixo:

• • Quando são mostradas páginas utilizando o protocolo HTTPS, a autoridade do certificado não se verifica.
  • Em Windows, os arquivos PDF só podem ser mostrados em uma janela externa.
  • Quando é mostrada uma área web em um novo processo, em particular, uma criada com o comando New process, é necessário definir um tamanho de pilha de pelo menos 256 KB (256*1024) com o propósito de ter certeza de sua correta visualização.

Em versões 64-bits, 4D inclui Blink de Google como motor de renderização Web embebido para áreas Web (integração em 4D é oferecida como preview).Usar este motor de renderização em áreas 4D Web é transparente para usuários, mas lembre que algumas diferenças em comportamento ou renderização podem ser observadas, assim como diferenças entre navegadores

 Propriedades de área Web e todos os comandos do tema Área Web são compatíveis. Entretanto, o motor  Blink tem as limitações abaixo:

• WA SET PAGE CONTENT: este comando exige que ao menos uma página já tenha sido carregada na área (através de uma chamada a  WA OPEN URL ou uma atribuição a variável URL associada à área)
• Execução de applets Java, JavaScripts e plug-ins está sempre disponível e não pode ser desativada em áreas Web usando Blink. Os seletores abaixo dos comandos WA SET PREFERENCE e WA GET PREFERENCE são ignorados:
  
  • WA enable Java applets
  • WA enable JavaScript
  • WA enable plugins
• Quando estiver ativo o "soltar" URL através do seletor WA enable URL drop dos comandos WA SET PREFERENCE e WA GET PREFERENCE deve ser precedido por ao menos uma chamada a  WA OPEN URL ou uma atruibção a variável URL associada à área.

Nota: esta opção só está disponível quando está ativada a opção Utilizar Web Kit integrado.

Quando esta propriedade está selecionada, um objeto JavaScript especial ($4d) é instanciado na área web e permite manipular as chamadas aos métodos projeto de 4D. Para obter mais informação sobre como funciona esta opção, consulte a seção Gestão programada de áreas web no manual de Linguagem de 4D.

Há quatro ações padrão específicas para a gestão automática de áreas de web: Abrir URL anterior, Abrir URL seguinte, Atualizar URL atual e Parar carregamento de URL. Estas ações podem ser associadas aos botões ou comandos de menus e permite implementar as interfaces de web básicas. Estas ações são descritas em Ações padrões.

As áreas web também podem controlar-se utilizando eventos formulário e comandos de linguagem específicos. Estes sã descritos no capítulo Área Web do manual de Linguagem de 4D. 

 Já que a exibição de Web areas é gerenciada por um motor de renderização externo, a localização dentro de formulários 4D é sujeita a limitações. Quando definir a localização das Web areas, é necessário considerar as seguintes restrições:

• Areas Web não são suportadas em subformulários "roláveis" (rolagem não vai ter o efeito desejado).
• Os limites das  Web areas não podem exceder àqueles dos subformulários que os contêm (devem ser inteiramente visíveis).
• Sobrepôr uma Web area em cima ou em baixo de outro objeto de formulário não é suportado.