HTMLLoader  - AS3

Spécifie si les requêtes d’authentification doivent être gérées (true) ou non (false) pour les requêtes HTTP publiées par cet objet. Si la valeur est false, les requêtes d’authentification renvoient une erreur HTTP.

La valeur par défaut est initialized from URLRequestDefaults.authenticate.

Eléments de l’API associés

Spécifie si les données de réponse doivent être mises en cache pour les requêtes HTTP publiées par cet objet. Si cette propriété est définie sur true, l’objet HTMLLoader utilise le cache HTTP du système d’exploitation.

La valeur par défaut est initialized from URLRequestDefaults.cacheResponse.

Eléments de l’API associés

Hauteur, en pixels, du contenu HTML. Cette propriété peut changer lorsque les dimensions de l’objet HTMLLoader sont modifiées. Par exemple, une page HTML utilise souvent la totalité de la hauteur de l’objet HTMLLoader, et la propriété contentHeight peut changer si vous modifiez la hauteur de l’objet HTMLLoader.

Plus d’exemples

Largeur, en pixels, du contenu HTML. Cette propriété peut changer lorsque les dimensions de l’objet HTMLLoader sont modifiées. Par exemple, une page HTML utilise souvent la totalité de la largeur de l’objet HTMLLoader, et la propriété contentWidth peut changer si vous modifiez la largeur de l’objet HTMLLoader.

Plus d’exemples

Indique si tout contenu de l’objet HTMLLoader peut recevoir le focus.

Spécifie la hauteur du rectangle des canevas HTML restitués. La valeur de cette propriété correspond à la hauteur de l’objet d’affichage HTMLLoader, en pixels. La valeur height maximale est de 4 095 pixels. Si cette propriété est modifiée, l'objet HTMLLoader restitue à nouveau le document HTML. La modification de cette propriété peut entraîner le déclenchement d’événements htmlBoundsChanged.

Lorsque vous définissez la propriété width ou height d’un objet HTMLLoader, les limites de l’objet changent, mais son contenu n’est pas mis à l’échelle (comme dans le cas des autres types d’objets d’affichage).

Longueur totale de la liste de l’historique, avec les entrées précédentes et suivantes. Cette propriété a la même valeur que la propriété JavaScript window.history.length de la page HTML.

Eléments de l’API associés

Position actuelle dans la liste de l’historique. La liste de l’historique correspond à l’objet window.history de la page HTML. Les entrées inférieures à la position actuelle sont les entrées « précédentes » de la liste ; les entrées supérieures sont les entrées « suivantes ». Lorsque vous tentez de définir la position au-delà de la fin, elle est définie sur la fin.

Eléments de l’API associés

Objet HTMLHost employé pour gérer les modifications apportées à certains éléments de l’interface utilisateur, par exemple à la propriété window.document.title de l’objet HTMLLoader. Pour remplacer les comportements par défaut de l’objet HTMLLoader, créez une sous-classe de la classe HTMLHost et remplacez ses fonctions de membre pour gérer les différentes modifications de l’interface utilisateur apportées au contenu HTML.

Eléments de l’API associés

Spécifie la valeur du délai d’inactivité (en millisecondes) pour les requêtes HTTP provenant de cet objet.

Le délai d’inactivité correspond au laps de temps que le client attend une réponse du serveur, une fois la connexion établie et avant l’abandon de la requête.

La valeur par défaut est initialized from URLRequestDefaults.idleTimeout.

Eléments de l’API associés

Indique si la classe HTMLLoader est prise en charge sur le système client.

Indique si l’événement JavaScript load correspondant à l’appel précédent de la méthode load() ou loadString() a été délivré au DOM HTML dans l’objet HTMLLoader. Cette propriété est true avant le déclenchement de l’événement complete. Il est possible que cette propriété ne devienne jamais true. Cela se produit comme lorsque l’événement complete n’est jamais déclenché.

URL du contenu chargé dans l’objet HTMLLoader.

Spécifie si la pile de protocoles HTTP doit gérer les cookies pour cet objet. Si la valeur true est définie, les cookies sont ajoutés à la requête et les cookies de réponse sont mémorisés. Si la valeur est false, les cookies ne sont pas ajoutés à la requête et les cookies de réponse ne sont pas mémorisés.

La valeur par défaut est initialized from URLRequestDefaults.manageCookies.

Eléments de l’API associés

Indique si la navigation de l’image racine du contenu HTML (par exemple lorsque l’utilisateur clique sur un lien, lorsque la propriété window.location est définie ou lors d’un appel à window.open()) entraîne une navigation dans l’objet HTMLLoader (false) ou dans le navigateur Web par défaut du système (true). Définissez cette propriété sur true pour que toute la navigation se produise dans le navigateur Web du système (pas dans l’objet HTMLLoader).

La valeur par défaut est false.

Spécifie si l’arrière-plan du document HTMLLoader est blanc opaque (true) ou non (false). Lorsque cette propriété est définie sur false, l’objet HTMLLoader utilise son conteneur d’objet d’affichage comme arrière-plan pour le code HTML et utilise l’opacité (valeur alpha) du conteneur d’objet d’affichage comme arrière-plan HTML. Toutefois, si l’élément body ou tout autre élément du document HTML a une couleur d’arrière-plan opaque (spécifiée par style="background-color:gray", par exemple), cette partie du rendu HTML utilise la couleur d’arrière-plan opaque spécifiée.

Plus d’exemples

Type de prise en charge PDF dans le système de l’utilisateur, définie sous forme de valeur de code d’entier. Un objet HTMLLoader ne peut afficher du contenu PDF que si la valeur de cette propriété est PDFCapability.STATUS_OK. La classe PDFCapability définit des constantes pour les valeurs possibles de la propriété pdfCapability, comme suit :

Plus d’exemples

Eléments de l’API associés

Spécifie si le contenu chargé à l’aide de la méthode loadString() est placé dans le sandbox de l’application (true) ou dans un sandbox non-applicatif (false).

Lorsque cette propriété est définie sur false, le contenu chargé à l’aide de la méthode loadString() est placé dans un sandbox non-applicatif avec les caractéristiques suivantes :

• Il est autorisé à charger du contenu depuis le réseau (mais pas depuis le système de fichiers).
• Il ne peut pas charger des données à l’aide de XMLHttpRequest.
• La propriété window.location est définie sur "about:blank".
• Le contenu ne peut pas accéder à la propriété window.runtime (comme le contenu se trouvant dans un sandbox non-applicatif).

Lorsque cette propriété est définie sur true, le contenu chargé à l’aide de la méthode loadString() est placé dans le sandbox de l’application et peut accéder à la propriété window.runtime, ainsi qu’à toutes les API d’AIR. Vérifiez la fiabilité de la source de données d’une chaîne utilisée lors d’un appel à la méthode loadString(). Les instructions de code dans la chaîne HTML sont exécutées avec des privilèges d’application complets lorsque cette propriété est définie sur true. Définissez cette propriété sur true uniquement si vous êtes certain que la chaîne ne contient aucun code néfaste.

Dans les applications compilées avec les kits de développement AIR 1.0 ou AIR 1.1, le contenu chargé à l’aide de la méthode loadString() est placé dans le sandbox de l’application.

La valeur par défaut est false.

Eléments de l’API associés

Domaine d’application à utiliser pour l’objet window.runtime dans le code JavaScript de la page HTML.

Si cette propriété est null, ou si le contenu HTML provient d’un autre domaine de sécurité que le contenu SWF contenant l’objet HTMLLoader, la page utilise un domaine d’application par défaut comme domaine.

Eléments de l’API associés

Position de défilement horizontal du contenu HTML dans l'objet HTMLLoader.

Plus d’exemples

Position de défilement vertical du contenu HTML dans l’objet HTMLLoader.

Plus d’exemples

Type de prise en charge SWF dans le système de l’utilisateur, défini sous forme de valeur de code d’entier. Un objet HTMLLoader ne peut afficher du contenu SWF que si la valeur de cette propriété est HTMLSWFCapability.STATUS_OK. La classe HTMLSWFCapability définit des constantes pour les valeurs possibles de la propriété swfCapability, comme suit :

Eléments de l’API associés

Codage de caractères utilisé par le contenu HTMLLoader lorsque la page HTML ne spécifie aucun codage de caractères. Une page HTML définit le codage de caractères dans une balise meta, comme dans l’exemple suivant :

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

Les valeurs sont définies dans la liste IANA des jeux de caractères valides.

Lorsque aucun encodage n’est spécifié par la page HTML, par la propriété textEncodingFallback ou textEncodingOverride, le contenu HTML utilise l’encodage ISO-8859-1.

Plus d’exemples

Eléments de l’API associés

Codage de caractères utilisé par le contenu HTMLLoader, remplaçant tous les paramètres de la page HTML. Une page HTML définit le codage de caractères dans une balise meta, comme dans l’exemple suivant :

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

Ce paramètre remplace également tous les paramètres de la propriété textEncodingFallback.

Les valeurs sont définies dans la liste IANA des jeux de caractères valides.

Définissez la propriété textEncodingOverride après le chargement du contenu HTML pour que AIR actualise le contenu HTML à l’aide de l’encodage spécifié. Lorsque HTMLLoader navigue vers une nouvelle page, vous devez redéfinir cette propriété pour que cette nouvelle page utilise un encodage spécifique.

Lorsque aucun encodage n’est spécifié par la page HTML, par la propriété textEncodingFallback ou textEncodingOverride, le contenu HTML utilise l’encodage ISO-8859-1.

La définition de la propriété textEncodingOverride sur null restaure le comportement par défaut.

Plus d’exemples

Eléments de l’API associés

Spécifie si le cache local doit être consulté avant que les requêtes HTTP publiées par cet objet ne récupèrent des données.

La valeur par défaut est initialized from URLRequestDefaults.useCache.

Eléments de l’API associés

Chaîne d’agent utilisateur à utiliser dans les requêtes de contenu entrantes provenant de cet objet HTMLLoader.

Pour définir la chaîne d’agent utilisateur, définissez la propriété userAgent de l’objet HTMLLoader avant d’appeler la méthode load(). La propriété userAgent de l’objet URLRequest transmis à la méthode load()n’est pas utilisée.

En définissant la propriété URLRequestDefaults.userAgent, vous pouvez définir la chaîne d’agent utilisateur par défaut employée par tous les objets HTMLLoader dans un domaine d’application. Lorsque aucune valeur n’est définie pour la propriété userAgent de l’objet HTMLLoader (ou si la valeur est définie sur null), la chaîne d’agent utilisateur est définie sur la valeur de la propriété statique URLRequestDefaults.userAgent.

Lorsque aucune valeur n’est définie pour la propriété userAgent de l’objet HTMLLoader et pour URLRequestDefaults.userAgent, une valeur par défaut est employée comme chaîne d’agent utilisateur. Cette valeur par défaut varie selon le système d’exploitation du moteur d’exécution (par exemple, Mac OS, Linux ou Windows), ainsi que du langage et de la version du moteur d’exécution, comme le montrent les exemples suivants :

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

Plus d’exemples

Eléments de l’API associés

Spécifie la largeur du rectangle des canevas HTML restitués. Il s’agit de la largeur de l’objet d’affichage HTMLLoader, en pixels. La valeur width maximale est de 4 095 pixels. Si cette propriété est modifiée, l'objet HTMLLoader restitue à nouveau le document HTML. La modification de cette propriété peut entraîner le déclenchement d’événements htmlBoundsChange. Lorsque vous définissez les propriétés width et height d’un objet HTMLLoader, les limites de l’objet changent, mais son contenu n’est pas mis à l’échelle (comme dans le cas des autres types d’objets d’affichage).

Objet JavaScript global du contenu chargé dans le contrôle HTML.

Crée un objet HTMLLoader.

Annule les opérations de chargement en cours.

Crée un nouvel objet NativeWindow contenant un objet HTMLLoader. Utilisez l’objet HTMLLoader renvoyé par cette méthode pour charger du contenu HTML.

Par défaut, (lorsque vous ne définissez pas de paramètres lors de l’appel à cette méthode), la nouvelle fenêtre utilise le chrome système standard et comprend des contrôles de barres de défilement pour le contenu. Vous pouvez définir les paramètres pour modifier les propriétés de la nouvelle fenêtre.

Lorsque la fenêtre charge du contenu et applique des feuilles de style, il est possible que des problèmes graphiques surviennent. Pour éviter que ce type de discontinuités soit visible, définissez le paramètre visible sur false. Lorsque la fenêtre a chargé et préparé son contenu, affichez-le en définissant la propriété window.nativeWindow.visible sur true ou appelez la méthode window.nativeWindow.activate().

Paramètres

Renvoie l’entrée de l’historique à la position spécifiée.

Paramètres

Eléments de l’API associés

Revient en arrière dans l’historique du navigateur, si possible.

Un appel à cette méthode de l’objet HTMLLoader revient à appeler la méthode back() de la propriété window.history dans le code JavaScript de la page HTML.

Cette fonction ne renvoie pas d’erreur.

Eléments de l’API associés

Avance dans l’historique du navigateur, si possible.

Un appel à cette méthode de l’objet HTMLLoader revient à appeler la méthode forward() de la propriété window.history dans le code JavaScript de la page HTML.

Cette fonction ne renvoie pas d’erreur.

Eléments de l’API associés

Navigue parmi le nombre d’étapes spécifiées dans l’historique du navigateur. Navigue vers l’avant si positif, vers l’arrière si négatif. Une navigation par zéro impose un nouveau chargement.

Cette méthode équivaut à appeler la méthode go() de la propriété window.history dans le code JavaScript de la page HTML.

Cette fonction ne renvoie pas d’erreur.

Paramètres

Eléments de l’API associés

Charge l’objet HTMLLoader avec les données provenant du site spécifié par le paramètre urlRequestToLoad. Un appel à cette méthode définit initialement la propriété loaded sur false. Cette méthode déclenche une opération qui se termine toujours de façon asynchrone.

Un appel à cette méthode annule implicitement toute opération de chargement en attente et initiée précédemment avec cette méthode ou avec la méthode loadString(). L’événement complete de l’opération de chargement précédente ne sera jamais distribué.

Il est possible que l’événement complete ne soit jamais distribué. Cela arrive lorsque le contenu HTML chargé dans l’objet HTMLLoader n’est jamais entièrement téléchargé. Ceci peut se produire si le contenu HTML fait référence à une URL qui dirige vers un script CGI générant du contenu indéfiniment et répétitivement.

Paramètres

Plus d’exemples

Eléments de l’API associés

Charge l’objet HTMLLoader avec le contenu HTML renfermé dans la chaîne HTML. Lorsque la restitution du code HTML de la chaîne est terminé, l’événement complete est déclenché. L’événement complete est toujours distribué de façon asynchrone.

Un appel à cette méthode annule implicitement toute opération de chargement en attente et initiée précédemment avec cette méthode ou avec la méthode load. L’événement complete de l’opération de chargement précédente ne sera jamais distribué.

Si le code HTML spécifié dans la chaîne ne fait pas référence à des ressources externes, cette méthode restitue le code HTML de façon synchrone. Toutefois, l’événement complete est toujours distribué de façon asynchrone. Si la propriété loaded de cette classe est true immédiatement après un appel à cette fonction, le contenu HTML spécifié dans l’argument htmlContent a été restitué de façon synchrone.

Il est possible que l’événement complete ne soit jamais distribué. Cela arrive lorsque le contenu HTML chargé dans l’objet HTMLLoader n’est jamais entièrement téléchargé. Ceci peut se produire si le contenu HTML fait référence à une URL qui dirige vers un script CGI générant du contenu indéfiniment et répétitivement.

Le contenu chargé à l’aide de la méthode loadString() est placé dans le sandbox de sécurité de l’application uniquement si la propriété placeLoadStringContentInApplicationSandbox est définie sur true.

Paramètres

Plus d’exemples

Eléments de l’API associés

Recharge la page à partir de l’emplacement en cours.

Signale que la dernière opération de chargement demandée par la méthode loadString ou load est terminée. L’événement est déclenché après que l’événement load JavaScript ait été déclenché sur le DOM HTML dans l’objet HTMLLoader. Cet événement est toujours distribué de façon asynchrone. Le gestionnaire de cet événement peut appeler toute méthode ou accéder à toute propriété de l'objet HTMLLoader.

Les propriétés de cet événement sont les suivantes :

Plus d’exemples

Eléments de l’API associés

Signale que l’une des propriétés contentWidth et contentHeight, ou les deux, ont été modifiées. Cela peut être le résultat du chargement d’une nouvelle image ou d’un autre contenu, par exemple. Les gestionnaires d’événement peuvent appeler n’importe quelle méthode ou accéder à n’importe quelle propriété de l’objet HTMLLoader.

L’objet HTMLLoader peut déclencher cet événement à tout moment après l’initiation d’une opération de chargement, même après que l’objet ait déclenché l’événement complete.

Les propriétés de cet événement sont les suivantes :

Plus d’exemples

Eléments de l’API associés

Signale que le DOM HTML a été créé en réponse à une opération de chargement. Les méthodes load() et loadString() de l’objet HTMLLoader renvoient une exception lorsque cet événement est distribué. Toute propriété ou méthode d’un objet JavaScript accessible depuis la propriété window de l’objet HTMLLoader qui contrôle l’URL chargée dans cet objet HTMLLoader renvoie une exception lorsqu’elle est définie ou appelée pendant le déclenchement de cet événement. Par exemple la définition de window.location via la propriété window de l’objet HTMLLoader résulte en une exception JavaScript.

Les propriétés de cet événement sont les suivantes :

Plus d’exemples

Eléments de l’API associés

Signale que le rendu du contenu de l’objet HTMLLoader est entièrement à jour. Cet événement peut être déclenché assez fréquemment, à chaque modification du rendu du contenu HTML. Par exemple, cet événement est déclenché lorsqu’un nouveau contenu apparaît car l’utilisateur a cliqué sur un lien ou lorsque le code JavaScript de la page est restitué sous forme HTML. Les écouteurs d’événement peuvent appeler toute méthode ou accéder à toute propriété de l’objet HTMLLoader.

Les gestionnaires de cet événement peuvent vérifier les propriétés contentWidth et contentHeight de l’objet HTMLLoader pour mettre à jour ses barres de défilement.

L’objet HTMLLoader peut déclencher cet événement à tout moment après l’initiation d’une opération de chargement, même après que l’objet ait déclenché l’événement complete.

Les propriétés de cet événement sont les suivantes :

Signale que la propriété location de l’objet HTMLLoader a été modifiée. Le gestionnaire de cet événement peut appeler toute méthode ou accéder à toute propriété de l'objet HTMLLoader.

Un événement locationChange de type LocationChangeEvent est distribué par l’objet HTMLLoader dans les applications qui utilisent l’espace de noms d’AIR 2.7 et versions ultérieures. Dans les versions antérieures d’AIR, l’objet d’événement distribué est une occurrence de la classe Event.

Plus d’exemples

Eléments de l’API associés

Signale que la propriété location de l’objet HTMLLoader a été modifiée. Le gestionnaire de cet événement peut appeler toute méthode ou accéder à toute propriété de l'objet HTMLLoader.

Un événement locationChange de type Event est distribué par l’objet HTMLLoader dans les applications qui utilisent l’espace de noms de versions AIR antérieures à 2.7. Dans AIR 2.7 et les versions ultérieures, l’objet d’événement est une occurrence de la classe LocationChangeEvent, qui fournit une autre propriété location définie sur l’URL de la nouvelle page.

Les propriétés de cet événement sont les suivantes :

Plus d’exemples

Eléments de l’API associés

Indique que la propriété location de l’objet HTMLLoader est sur le point de changer.

Un événement locationChanging est distribué uniquement lorsque le changement d’emplacement est initié par le biais d’une interaction de l’utilisateur (notamment lorsqu’un utilisateur clique sur un lien) ou lorsque le code s’exécute à l’intérieur de l’objet HTMLLoader (notamment dans le cas d’une redirection côté client). Par défaut, le nouvel emplacement est affiché dans cet objet HTMLLoader. Vous pouvez appeler la méthode preventDefault() de l’objet d’événement pour annuler le comportement par défaut. Par exemple, vous pouvez utiliser la fonction flash.net.navigateToURL() pour ouvrir la page dans le navigateur système en fonction de la propriété location de l’objet d’événement..

L’événement locationChanging() n’est pas distribué lorsque vous appelez les méthodes suivantes :

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

En outre, cet événement n’est pas distribué lorsque la propriété navigateInSystemBrowser est définie sur true et lorsque la page de destination est ouverte dans le navigateur système, car l’emplacement de l’objet HTMLLoader ne change pas.

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();
            }
        }
    }
}

Signale que la propriété scrollH ou scrollV a été modifiée par l’objet HTMLLoader. L’objet HTMLLoader distribue cet événement lorsque le code JavaScript s’exécutant dans l’objet HTMLLoader invoque la méthode scrollTo() de l’objet window et que l’emplacement désiré n’est pas encore visible. L’événement n’est pas déclenché lorsque le code ActionScript modifie la propriété scrollH ou scrollV. Les gestionnaires d’événement peuvent appeler n’importe quelle méthode ou accéder à n’importe quelle propriété de l’objet HTMLLoader.

Les gestionnaires de cet événement peuvent vérifier les propriétés scrollH et scrollV pour mettre à jour les barres de défilement associées à l’objet HTMLLoader.

L’objet HTMLLoader peut déclencher cet événement à tout moment après l’initiation d’une opération de chargement, même après que l’objet ait déclenché l’événement complete.

Les propriétés de cet événement sont les suivantes :

Plus d’exemples

Signale qu’une exception JavaScript non interceptée s’est produite dans l’objet HTMLLoader. Les gestionnaires d’événement peuvent appeler toute méthode ou accéder à toute propriété de l’objet HTMLLoader. L’événement peut être annulé et le comportement par défaut lors d’une exécution dans l’application de débogage du lanceur AIR consiste à envoyer la pile JavaScript pour effectuer le suivi du résultat.

Les propriétés de cet événement sont les suivantes :

Plus d’exemples

Eléments de l’API associés