getURL (méthode MovieClip.getURL)

 
public getURL(url:String, [window:String], [method:String]) : Void

Charge un document à partir de l'URL spécifiée dans la fenêtre spécifiée. Vous pouvez également utiliser la méthode getURL() pour transmettre des variables à une autre application définie à l'URL en utilisant une méthode GET ou POST.

Les pages Web qui hébergent un contenu Flash doivent définir de façon explicite l'attribut allowScriptAccess pour autoriser ou bloquer la programmation de Flash Player à l'aide de code HTML (dans la balise PARAM d'Internet Explorer ou EMBED de Netscape Navigator) :

• Lorsque allowScriptAccess a pour valeur “never”, les scripts externes échouent systématiquement.
• Lorsque allowScriptAccess a pour valeur “always”, les scripts externes sont acceptés systématiquement.
• Lorsque allowScriptAccess a pour valeur “sameDomain” (pris en charge par les fichiers SWF à partir de la version 8 ), les scripts externes sont autorisés si le fichier SWF provient du même domaine que la page Web hébergeante.
• Si allowScriptAccess n'est pas spécifié par une page HTML, la valeur par défaut est “sameDomain” pour les fichiers SWF de la version 8, et la valeur par défaut est “always” pour les fichiers SWF des versions antérieures.

Lorsque vous utilisez cette méthode, tenez compte du modèle de sécurité Flash Player. Pour Flash Player 8, la méthode n'est pas autorisée si le fichier SWF appelant est dans le sandbox local avec système de fichier et que la ressource n'est pas locale.

Pour plus d'informations, voir les sections suivantes :

• Chapitre 17, ” Fonctionnement de la sécurité ”, du manuel Formation à ActionScript 2.0 dans Flash
• Livre blanc sur la sécurité de Flash Player 8 disponible à l'adresse : http://www.macromedia.com/go/fp8_security
• Livre blanc sur les API relatif à la sécurité de Flash Player 8 disponible à l'adresse : http://www.macromedia.com/go/fp8_security_apis

Vous pouvez étendre les méthodes et les gestionnaires d'événements de la classe MovieClip en créant une sous-classe.

Disponibilité : ActionScript 1.0 ; Flash Player 5

url:String - URL permettant d'obtenir le document.

window:String [facultatif] - Paramètre spécifiant le nom, le cadre ou l'expression qui spécifie la fenêtre ou le cadre HTML où le document est chargé. Vous pouvez également utiliser l'un des noms cible réservés suivants : _self spécifie l'image actuelle dans la fenêtre actuelle, _blank spécifie une nouvelle fenêtre, _parent spécifie le parent de l'image actuelle et _top spécifie l'image de plus haut niveau dans la fenêtre actuelle.

method:String [facultatif] - Chaîne (“GET” ou “POST”)) qui spécifie une méthode d'envoi de variables associées au fichier SWF à charger. En l'absence de ces variables, omettez ce paramètre ; sinon, spécifiez si les variables doivent être chargées avec la méthode GET ou POST. La méthode GET ajoute les variables à la fin de l'URL et est utilisée lorsque les variables sont peu nombreuses. La méthode POST place les variables dans un en-tête HTTP distinct et s'applique aux variables longues de type chaîne.

Le code ActionScript suivant crée une occurrence de clip et ouvre le site Web de Macromedia dans une nouvelle fenêtre :

this.createEmptyMovieClip("loader_mc", this.getNextHighestDepth());
loader_mc.getURL("http://www.macromedia.com", "_blank");

La méthode getURL() permet également d'envoyer des variables à un script distant, côté serveur, comme indiqué dans le code suivant :

this.createEmptyMovieClip("loader_mc", this.getNextHighestDepth());
loader_mc.username = "some user input";
loader_mc.password = "random string";
loader_mc.getURL("http://www.flash-mx.com/mm/viewscope.cfm", "_blank", "GET");

La méthode MovieClip.getNextHighestDepth() utilisée dans ces exemples nécessite Flash Player 7 ou une version ultérieure. Si votre fichier SWF comprend un composant de la version 2, utilisez les composants de la version 2 de la classe DepthManager au lieu de la méthode MovieClip.getNextHighestDepth().

Lorsque vous utilisez cette méthode, tenez compte du modèle de sécurité Flash Player.

• Pour Flash Player 8, la méthode MovieClip.getURL() n'est pas autorisée si le fichier SWF appelant est dans le sandbox local avec système de fichier et que la ressource n'est pas locale.

Pour plus d'informations, voir les sections suivantes :

• Chapitre 17, “Fonctionnement de la sécurité”, dans Formation à ActionScript 2.0 dans Flash
• Le livre blanc sur la sécurité de Flash Player 8 disponible à l'adresse : http://www.macromedia.com/go/fp8_security
• Le livre blanc sur les API relatif à la sécurité de Flash Player 8 disponible à l'adresse : http://www.macromedia.com/go/fp8_security_apis

Fonction getURL, sendAndLoad (méthode LoadVars.sendAndLoad), send (méthode LoadVars.send)