HTMLLoader  - AS3

Especifica se as solicitações de autenticação devem ser manipuladas (true) ou não (false) para solicitações HTTP emitidas por este objeto. Se for false, os desafios de autenticação retornam um erro HTTP.

O valor padrão é initialized from URLRequestDefaults.authenticate.

Elementos da API relacionados

Especifica se os dados de resposta bem-sucedidos devem ser armazenados em cache para as solicitações HTTP enviadas por este objeto. Ao ser definido como true, o objeto HTMLLoader usará o cache HTTP do sistema operacional.

O valor padrão é initialized from URLRequestDefaults.cacheResponse.

Elementos da API relacionados

A altura, em pixels, do conteúdo HTML. Essa propriedade pode alterar as dimensões da alteração do objeto HTMLLoader. Por exemplo, uma página HTML usa geralmente a altura inteira do objeto HTMLLoader, e a propriedade contentHeight pode ser alterada se a altura do objeto HTMLLoader for alterada.

A largura, em pixels, do conteúdo HTML. Essa propriedade pode alterar as dimensões da alteração do objeto HTMLLoader. Por exemplo, uma página HTML usa geralmente a largura inteira do objeto HTMLLoader, e a propriedade contentWidth pode ser alterada se a largura do objeto HTMLLoader for alterada.

Indica se algum conteúdo do objeto HTMLLoader é focalizável.

Especifica a altura do retângulo da tela HTML em renderização. Este valor de propriedade é a altura do objeto de exibição HTMLLoader em pixels. O valor máximo da altura é 4095 pixels. A alteração dessa propriedade fará com que o objeto HTMLLoader renderize novamente o documento HTML. Os eventos htmlBoundsChanged podem ser despachados em resposta à alteração dessa propriedade.

Quando você define as propriedades width e height de um objeto HTMLLoader, os limites do objeto são alterados, mas o conteúdo não é dimensionado (como aconteceria com outros tipos de objetos de exibição).

O comprimento geral da lista do histórico, incluindo entradas dianteiras e traseiras. Essa propriedade possui o mesmo valor da propriedade JavaScript window.history.length da página HTML.

Elementos da API relacionados

A posição atual na lista do histórico. A lista de histórico corresponde ao objeto window.history da página HTML. As entradas inferiores à posição atual são da lista "back"; as entradas maiores são "forward." Tentativas de definir a posição além do final a definirão para o final.

Elementos da API relacionados

O objeto HTMLHost usado para lidar com as alterações em certos elementos da interface do usuário, tais como a propriedade window.document.title do objeto HTMLLoader. Para substituir os comportamentos padrão do objeto HTMLLoader, crie uma subclasse da classe HTMLHost e substitua as suas funções de membro para manipular várias alterações de interface do usuário no conteúdo HTML.

Elementos da API relacionados

Especifica o valor de tempo limite ocioso (em milissegundos) para pedidos de HTTP emitidos por este objeto.

O tempo limite ocioso é o período de tempo (em milissegundos) que o cliente espera por uma resposta do servidor, depois que a conexão é estabelecida, antes de abandonar o pedido.

O valor padrão é initialized from URLRequestDefaults.idleTimeout.

Elementos da API relacionados

Indica se a classe HTMLLoader é suportada no sistema do cliente.

Indica se o evento load do JavaScript correspondente à chamada anterior para o método load() ou loadString() foi entregue ao HTML DOM no objeto HTMLLoader. Essa propriedade é true antes de o evento complete ser despachado. É possível que essa propriedade nunca seja true. Isso sempre acontece quando o evento complete nunca é despachado.

O URL para o conteúdo carregado no objeto HTMLLoader.

Especifica se a pilha de protocolo HTTP deve gerenciar cookies para este objeto. Se true, cookies serão adicionados à solicitação e cookies de resposta serão memorizados. Se for false, os cookies não são adicionados à solicitação e os cookies de resposta não são lembrados.

O valor padrão é initialized from URLRequestDefaults.manageCookies.

Elementos da API relacionados

Especifica se a navegação do quadro-raiz do conteúdo HTML (por exemplo, quando o usuário clica em um link, quando a propriedade window.location é definida ou ao chamar window.open()) resulta em navegação no objeto HTMLLoader (false) ou no navegador da web padrão do sistema (true). Defina esta propriedade como true se desejar que toda a navegação ocorra no navegador da web do sistema (não no objeto HTMLLoader).

O valor padrão é false.

Determina se o segundo plano do documento HTMLLoader é branco opaco (true) ou não (false). Se essa propriedade estiver definida como false, o objeto HTMLLoader usa seu contêiner de objeto de exibição como segundo plano para o HTML e usa a opacidade (valor alpha) do contêiner de objeto de exibição como segundo plano do HTML. Entretanto, se o elemento body ou qualquer outro elemento do documento HTML tiver uma cor de segundo plano opaca (especificada por style="background-color:gray", por exemplo), parte do HTML renderizado usará a cor de segundo plano opaca.

O tipo de suporte a PDF no sistema do usuário, definido como um valor de código integral. Um objeto HTMLLoader pode exibir o conteúdo PDF somente se esta propriedade avaliar PDFCapability.STATUS_OK. A classe PDFCapability define constantes para valores possíveis da propriedade pdfCapability conforme a seguir:

Elementos da API relacionados

Especifica se o conteúdo carregado através do método loadString() é colocado na área de segurança do aplicativo (true) ou em uma área de segurança não aplicativo (false).

Quando essa propriedade está definida como false, o conteúdo carregado por meio do método loadString() é colocado em uma caixa de proteção que não seja do aplicativo com as seguintes características:

• Ela tem acesso ao conteúdo carregado na rede (mas não no sistema de arquivos).
• Ela não pode carregar dados usando XMLHttpRequest.
• A propriedade window.location é definida como "about:blank".
• O conteúdo não pode acessar a propriedade window.runtime (assim como o conteúdo em qualquer caixa de proteção que não seja do aplicativo).

Quando essa propriedade está definida como true, o conteúdo carregado por meio do método loadString() é colocado na caixa de proteção do aplicativo, com acesso à propriedade window.runtime e a todas as APIs do AIR. Você deve verificar se a fonte de dados de uma string usada em uma chamada para o método loadString() é confiável. Instruções de código na string HTML são executadas com todos os privilégios do aplicativo quando essa propriedade está definida como true. Você só deve definir essa propriedade como true quando tiver certeza de que a string não pode conter código mal-intencionado.

Em aplicativos compilados com SDKs do AIR 1.0 ou do AIR 1.1, o conteúdo carregado por meio do método loadString() é colocado na caixa de proteção do aplicativo.

O valor padrão é false.

Elementos da API relacionados

O domínio do aplicativo a ser usado no objeto window.runtime no JavaScript na página HTML.

Se for null ou se o conteúdo HTML estiver em um domínio de segurança diferente do conteúdo SWF que contém o objeto HTMLLoader, a página usará um domínio do aplicativo padrão como seu domínio.

Elementos da API relacionados

A posição da barra de rolagem horizontal do conteúdo HTML no objeto HTMLLoader.

A posição da barra de rolagem vertical do conteúdo HTML no objeto HTMLLoader.

O tipo de suporte a SWF no sistema do usuário, definido como um valor de código integral. Um objeto HTMLLoader poderá exibir o conteúdo SWF somente se esta propriedade avaliar HTMLSWFCapability.STATUS_OK. A classe PDFCapability define constantes para valores possíveis da propriedade swfCapability conforme a seguir:

Elementos da API relacionados

A codificação de caractere usado pelo conteúdo HTMLLoader se uma página HTML não especificar uma codificação de caracteres. Uma página HTML especifica a codificação de caractere em uma marca meta, como a seguinte:

<meta http-equiv="content-type" content="text/html" charset="ISO-8859-1">

Os valores são definidos na lista IANA de conjuntos de caracteres válidos.

Se nenhuma codificação for especificada pela página HTML pela propriedade textEncodingFallback ou pela propriedade textEncodingOverride, o conteúdo HTML usará a codificação ISO-8859-1.

Elementos da API relacionados

O caractere codificado usado pelo conteúdo HTMLLoader, substituindo qualquer configuração na página HTML. Uma página HTML especifica a codificação de caractere em uma marca meta, como a seguinte:

<meta http-equiv="content-type" content="text/html" charset="ISO-8859-1">

Esta definição também substitui qualquer definição na propriedade textEncodingFallback.

Os valores são definidos na lista IANA de conjuntos de caracteres válidos.

Defina a propriedade textEncodingOverride depois de o conteúdo HTML ser carregado para que o AIR atualize o conteúdo HTML usando a codificação especificada. Depois que o HTMLLoader navegar para uma nova página, será necessário definir a propriedade novamente se desejar que a nova página use a codificação específica.

Se nenhuma codificação for especificada pela página HTML pela propriedade textEncodingFallback ou pela propriedade textEncodingOverride, o conteúdo HTML usará a codificação ISO-8859-1.

A definição da propriedade textEncodingOverride para null recupera o comportamento padrão.

Elementos da API relacionados

Especifica se o cache local deve ser consultado antes que as solicitações HTTP emitidas por este objeto realizem a busca dos dados.

O valor padrão é initialized from URLRequestDefaults.useCache.

Elementos da API relacionados

A string user agent a ser usada em qualquer solicitação de conteúdo a ser apresentado a partir deste objeto HTMLLoader.

Para definir a string user agent, defina a propriedade userAgent do objeto HTMLLoader antes de chamar o método load(). A propriedade userAgent do objeto URLRequest transmitida para o método load() não é usada.

Você pode definir a string de agente do usuário padrão usada pelos objetos HTMLLoader no domínio de um aplicativo configurando a propriedade URLRequestDefaults.userAgent. Se nenhum valor for definido para a propriedade userAgent do objeto HTMLLoader (ou se o valor for definido como null), o valor da string de agente do usuário será definido como o da propriedade estática URLRequestDefaults.userAgent.

Se um valor não for definido para a propriedade userAgent do HTMLLoader nem para URLRequestDefaults.userAgent, será usado um valor padrão como a string user agent. Esse valor padrão varia em função do sistema operacional do tempo de execução (tal como Mac OS, Linux ou Windows), do idioma do tempo de execução e da versão, como nos dois exemplos a seguir:

• "Mozilla/5.0 (Macintosh; U; PPC Mac OS X; en) AppleWebKit/526.9+ (KHTML, como Gecko) AdobeAIR/1.5"
• "Mozilla/5.0 (Windows; U; en) AppleWebKit/526.9+ (KHTML, como Gecko) AdobeAIR/1.5"
• "Mozilla/5.0 (X11; U; Linux i686; en-US) AppleWebKit/526.9+ (KHTML, como Gecko) AdobeAIR/1.5"

Elementos da API relacionados

Especifica a largura do retângulo da tela HTML em renderização. Esta é a largura do objeto de exibição HTMLLoader em pixels. O valor máximo da largura é 4095 pixels. A alteração dessa propriedade fará com que o objeto HTMLLoader renderize novamente o documento HTML. Os eventos htmlBoundsChange podem ser despachados em resposta à alteração dessa propriedade. Quando você define as propriedade largura e altura de um objeto HTMLLoader, os limites do objeto são alterados, mas o conteúdo não é dimensionado (como aconteceria com outros tipos de objetos de exibição).

O objeto global JavaScript para o conteúdo carregado no controle HTML.

Cria um objeto HTMLLoader.

Cancela qualquer operação de carga em andamento.

Cria um novo objeto NativeWindow que contém um objeto HTMLLoader. Usa o objeto HTMLLoader que retornou por meio deste método para carregar o conteúdo HTML.

Por padrão (ao não definir parâmetros na chamada deste método), a nova janela usará o sistema cromo padrão e incluirá controles de barra de rolagem para o conteúdo. Você pode definir os parâmetros para alterar as propriedades da nova janela.

Como a janela carrega o conteúdo e aplica folhas de estilo, problemas gráficos de menor importância podem ocorrer. Para impedir que essas descontinuidades sejam visíveis, defina o parâmetro visible como false. Quando a janela carregar e desenhar o seu conteúdo, revele-o definindo a propriedade window.nativeWindow.visible como true ou chame o método window.nativeWindow.activate().

Parâmetros

Retorna a entrada do histórico na posição especificada.

Parâmetros

Elementos da API relacionados

Navega de volta para o histórico do navegador, se possível.

A chamada desse método do objeto HTMLLoader possui o mesmo efeito de uma chamada ao método back() da propriedade window.history em JavaScript na página HTML.

Esta função não lança nenhum erro.

Elementos da API relacionados

Navega para frente no histórico do navegador, se possível.

A chamada desse método do objeto HTMLLoader possui o mesmo efeito de uma chamada ao método forward() da propriedade window.history em JavaScript na página HTML.

Esta função não lança nenhum erro.

Elementos da API relacionados

Navegue no número indicado de etapas no histórico do navegador. Navegue para frente, se for positivo, e para trás, se for negativo. A navegação por zero força uma recarga.

Este método é equivalente a chamar o método go() da propriedade window.history em JavaScript na página HTML.

Esta função não lança nenhum erro.

Parâmetros

Elementos da API relacionados

Carrega o objeto HTMLLoader com dados do site especificado pelo parâmetro urlRequestToLoad. A chamada deste método inicialmente define a propriedade loaded para false. Este método inicia uma operação que é sempre concluída de modo assíncrono.

Uma chamada para esse método cancela implicitamente qualquer operação anterior de carregamento pendente iniciada com ele ou com o método loadString(). O evento complete para a operação anterior de carregamento nunca será entregue.

É possível que o evento complete nunca seja entregue. Isso acontece se qualquer conteúdo HTML carregado no objeto HTMLLoader nunca foi baixado completamente. Isso pode acontecer se o conteúdo HTML fizer referência a um URL para um script CGI que repetidamente gera um conteúdo indefinidamente.

Parâmetros

Elementos da API relacionados

Carrega o objeto HTMLLoader com o conteúdo HTML contido na string HTML. Quando a renderização do HTML na string for concluída, o evento complete será despachado. O evento complete é sempre despachado assincronamente.

Uma chamada para esse método cancela implicitamente qualquer operação anterior de carregamento pendente iniciada com ele ou com o método load(). O evento complete para a operação anterior de carregamento nunca será entregue.

Se o HTML especificado na string não tiver referências a recursos externos, este método renderizará o HTML de modo síncrono. Contudo, o evento complete ainda será despachado assincronamente. Se a propriedade loaded desta classe for true seguindo imediatamente uma chamada para esta função, o conteúdo HTML especificado no argumento htmlContent foi renderizado de modo assincronamente.

É possível que o evento complete nunca seja entregue. Isso acontece se qualquer conteúdo HTML carregado no objeto HTMLLoader nunca foi baixado completamente. Isso pode acontecer se o conteúdo HTML fizer referência a um URL para um script CGI que repetidamente gera um conteúdo indefinidamente.

Conteúdo carregado por meio do método loadString() só é colocado na área de segurança do aplicativo caso a propriedade placeLoadStringContentInApplicationSandbox seja definida como true.

Parâmetros

Elementos da API relacionados

Recarrega a página a partir do local atual.

Sinaliza que a última operação de carregamento solicitada pelo método loadString ou load foi concluída. O evento é despachado depois de o evento JavaScript load ter disparado no HTML DOM no objeto HTMLLoader. Este evento é sempre despachado assincronamente. O manipulador de evento deste evento pode chamar qualquer método ou acessar qualquer propriedade do objeto HTMLLoader.

Esse evento tem as seguintes propriedades:

Elementos da API relacionados

Sinaliza que uma ou ambas as propriedades contentWidth e contentHeight do objeto HTMLLoader foram alteradas. Isso pode resultar em uma nova imagem ou no carregamento de um outro conteúdo, por exemplo. Manipuladores de evento chamam qualquer método ou acessam qualquer propriedade do objeto HTMLLoader.

O objeto HTMLLoader pode despachar este evento a qualquer momento depois de iniciada uma operação de carregamento, mesmo após o objeto despachar o evento complete.

Esse evento tem as seguintes propriedades:

Elementos da API relacionados

Sinaliza que o HTML DOM foi criado em resposta a uma operação de carregamento. Os métodos load() e loadString() do objeto HTMLLoader lançam uma exceção enquanto este evento é despachado. Qualquer propriedade ou método de qualquer objeto JavaScript acessível a partir da propriedade window do objeto HTMLLoader que controla o URL carregado no objeto HTMLLoader lança uma exceção se for definido ou chamado enquanto o evento é despachado. Por exemplo, definir window.location configurando a propriedade window do objeto HTMLLoader resulta em uma exceção JavaScript.

Esse evento tem as seguintes propriedades:

Elementos da API relacionados

Sinaliza que a renderização do conteúdo no objeto HTMLLoader foi completamente atualizada. Este evento pode ser despachado com frequência—sempre que qualquer alteração de renderização é feita no conteúdo HTML. Por exemplo, este evento é despachado quando um novo conteúdo é exibido como resultado de um clique do usuário em um link ou quando o JavaScript da página renderiza o HTML. Ouvintes de evento podem chamar qualquer método ou acessar qualquer propriedade do objeto HTMLLoader.

Os manipuladores deste evento devem verificar as propriedades contentWidth e contentHeight do objeto HTMLLoader para atualizar qualquer barra de rolagem associada a ele.

O objeto HTMLLoader pode despachar este evento a qualquer momento depois de iniciada uma operação de carregamento, mesmo após o objeto despachar o evento complete.

Esse evento tem as seguintes propriedades:

Sinaliza que a propriedade location do objeto HTMLLoader foi alterada. O manipulador de evento deste evento pode chamar qualquer método ou acessar qualquer propriedade do objeto HTMLLoader.

A locationChange o evento do tipo LocationChangeEvent é despachado pelo HTMLLoader em aplicativos que usam AIR namespace 2.7 e depois. Em versões mais recentes do AIR, o objeto de evento despachado é uma instância da classe Event.

Elementos da API relacionados

Sinaliza que a propriedade location do objeto HTMLLoader foi alterada. O manipulador de evento deste evento pode chamar qualquer método ou acessar qualquer propriedade do objeto HTMLLoader.

Um evento locationChange do tipo Event é despachado pelo HTMLLoader em aplicativos que usam o namespace de um AIR anterior ao 2.7. No AIR 2.7 e posterior, o objeto de evento é uma instância da classe LocationChangeEvent, que fornece um conjunto de propriedades location adicional à URL da nova página.

Esse evento tem as seguintes propriedades:

Elementos da API relacionados

Sinaliza que a propriedadelocation do objeto HTMLLoader está prestes a ser alterada.

Um evento locationChanging é despachado apenas quando a alteração de local é iniciada pela interação do usuário, como quando um usuário clica em um link, ou pelo código executado no HTMLLoader, como um redirecionamento pelo cliente. Por padrão, o novo local é exibido nesse objeto HTMLLoader. Você pode chamar o método preventDefault() do objeto de evento para cancelar o comportamento padrão. Por exemplo, você pode usar a função flash.net.navigateToURL() para abrir a página no navegador do sistema com base na propriedade location do objeto de evento.

Um evento locationChanging() não é despachado quando você chama os seguintes métodos:

• load()
• loadString()
• reload()
• historyBack()
• historyForward()
• historyGo()

Além disso, este evento não é despachado quando a propriedade navigateInSystemBrowser é true e a página de destino é aberta no navegador de sistema, desde que o local HTMLLoader não seja alterado.

package{
    import flash.display.Sprite;
    import flash.html.HTMLLoader;
    import flash.net.URLRequest;
    
    public class LocationChanging extends Sprite
    {
        var htmlLoader:HTMLLoader = new HTMLLoader();
        public function LocationChanging()
        {
            htmlLoader.width = stage.stageWidth;
            htmlLoader.height = stage.stageHeight;        
            htmlLoader.addEventListener( LocationChangeEvent.LOCATION_CHANGING, onLocationChanging );
            htmlLoader.load( new URLRequest( "http://www.adobe.com" ) );
            this.addChild( htmlLoader );
        }
    
        private function onLocationChanging( event:LocationChangeEvent ):void
        {
            trace( "Location changing: " + event.location );
        
            if ( event.location.indexOf( "http://www.adobe.com" ) < 0 ) 
            {
                event.preventDefault();
            }
        }
    }
}

Sinaliza que a propriedade scrollH ou scrollV foi alterada pelo objeto HTMLLoader. O objeto HTMLLoader despacha este evento quando o JavaScript em execução no objeto HTMLLoader invoca o método scrollTo() do objeto window e o local desejado ainda não é visível. O evento não é despachado quando o código ActionScript altera a propriedade scrollH ou a scrollV. Manipuladores de evento chamam qualquer método ou acessam qualquer propriedade do objeto HTMLLoader.

Manipuladores de evento para este evento devem verificar as propriedades scrollH e scrollV para atualizar quaisquer barras de rolagem associadas com o objeto HTMLLoader.

O objeto HTMLLoader pode despachar este evento a qualquer momento depois de iniciada uma operação de carregamento, mesmo após o objeto despachar o evento complete.

Esse evento tem as seguintes propriedades:

Sinaliza que uma exceção JavaScript não capturada ocorreu no objeto HTMLLoader. Manipuladores de evento chamam qualquer método ou acessam qualquer propriedade do objeto HTMLLoader. O evento é cancelável e o comportamento padrão durante a execução do AIR Debug Launcher é enviar a pilha do JavaScript para a saída trace.

Esse evento tem as seguintes propriedades:

Elementos da API relacionados