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

Charge un document en provenance d’une URL spécifique dans une fenêtre ou transmet des variables à une autre application à une URL donnée. Pour tester cette fonction, assurez-vous que le fichier à charger existe à l’emplacement prévu. Pour utiliser une URL absolue (par exemple, “http://www.myserver.com“), vous devez disposer d’une connexion réseau.

Disponibilité : Flash Player 4 ; ActionScript 1.0

url:String - L’URL permettant d’obtenir le document.

window:String [facultatif] - Spécifie la fenêtre ou le cadre HTML dans lequel le document doit se charger. Vous pouvez entrer le nom d’une fenêtre spécifique ou le sélectionner à partir des noms cibles réservés suivants :

• _self spécifie le cadre actif de la fenêtre en cours d’utilisation.
• _blank crée une fenêtre.
• _parent appelle le parent du cadre actif.
• _top sélectionne le cadre de plus haut niveau de la fenêtre active.

method:String [facultatif] - Une méthode GET ou POST permettant d’envoyer des variables. En l’absence de variables, omettez ce paramètre. 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.

Cet exemple charge une image dans un clip. Lorsque l’utilisateur clique sur l’image, une nouvelle URL est chargée dans une nouvelle fenêtre de navigateur.

var listenerObject:Object = new Object();
listenerObject.onLoadInit = function(target_mc:MovieClip) {
 target_mc.onRelease = function() {
 getURL("http://www.macromedia.com/software/flash/flashpro/", "_blank");
 };
};
var logo:MovieClipLoader = new MovieClipLoader();
logo.addListener(listenerObject);
logo.loadClip("http://www.helpexamples.com/flash/images/image1.jpg",
 this.createEmptyMovieClip("macromedia_mc", this.getNextHighestDepth()));

Dans l’exemple suivant, la fonction getURL() est utilisée pour envoyer un message électronique :

myBtn_btn.onRelease = function(){
 getURL("mailto:you@somedomain.com");
};

Dans le code ActionScript suivant, JavaScript est utilisé pour ouvrir une fenêtre d’alerte lorsque le fichier SWF est intégré à une fenêtre de navigateur (sachez que lorsque vous appelez JavaScript à l’aide de getURL(), le paramètre url est limité à 508 caractères) :

myBtn_btn.onRelease = function(){
 getURL("javascript:alert('you clicked me')");
};

Vous pouvez également utiliser la méthode GET ou POST pour envoyer des variables. L’exemple suivant utilise la méthode GET pour ajouter des variables à une URL :

var firstName:String = "Gus";
var lastName:String = "Richardson";
var age:Number = 92;
myBtn_btn.onRelease = function() {
 getURL("http://www.macromedia.com", "_blank", "GET");
};

Le code ActionScript suivant utilise la méthode POST pour placer les variables dans l’en-tête HTTP. Assurez-vous de tester vos documents dans une fenêtre de navigateur ; sinon, vos variables sont envoyées à l’aide de la méthode GET :

var firstName:String = "Gus";
var lastName:String = "Richardson";
var age:Number = 92;
getURL("http://www.macromedia.com", "_blank", "POST");

Fonction loadVariables, send (méthode XML.send, sendAndLoad (méthode XML.sendAndLoad