Le diagramme suivant illustre la relation existant entre l’environnement JavaScript et l’environnement du moteur d’exécution AIR. Bien qu’une seule fenêtre native soit affichée, une application AIR peut contenir plusieurs fenêtres. (De même, une seule fenêtre peut comprendre de multiples objets HTMLLoader.)
Afficher le graphique en taille réelle
L’environnement JavaScript possède ses propres objets Document et Window. Le code JavaScript a des interactions avec l’environnement du moteur d’exécution AIR via les propriétés runtime, nativeWindow et htmlLoader. Quant au code ActionScript, il interagit avec l’environnement JavaScript par le biais de la propriété window
d’un objet HTMLLoader, lequel fait référence à l’objet Window JavaScript. En outre, les objets ActionScript et JavaScript permettent d’écouter des événements envoyés à la fois par des objets AIR et JavaScript.
La propriété
runtime
offre un accès aux classes API AIR, ce qui vous permet de créer de nouveaux objets AIR de même que d’accéder aux membres de la classe (également appelée statique). Pour accéder à une API AIR, ajoutez le nom de la classe (package compris) à la propriété
runtime
. Par exemple, pour créer un objet File, utilisez l’instruction suivante :
var file = new window.runtime.filesystem.File();
Remarque :
le kit de développement d’AIR contient un fichier JavaScript, intitulé
AIRAliases.js
, qui définit des alias plus pratiques pour les classes AIR les plus courantes. Lors de l’importation de ce fichier, vous pouvez utiliser la forme abrégée air.Class au lieu de window.runtime.package.Class. Vous pourriez, par exemple, créer l’objet File à l’aide de
new air.File()
.
L’objet NativeWindow offre des propriétés permettant de contrôler la fenêtre du poste de travail. A partir d’une page HTML, vous pouvez accéder à l’objet NativeWindow conteneur à l’aide de la propriété
window.nativeWindow
.
L’objet HTMLLoader propose des propriétés, des méthodes et des événements destinés à contrôler les modes de chargement et de rendu du contenu. A partir d’une page HTML, vous pouvez accéder à l’objet HTMLLoader parent à l’aide de la propriété
window.htmlLoader
.
Important :
seules les pages installées dans le cadre d’une application disposent des propriétés
htmlLoader
,
nativeWindow
ou
runtime
et ce, uniquement lorsqu’elles sont chargées en tant que document de niveau supérieur. Ces propriétés ne sont pas ajoutées dans le cas où le document est chargé dans une image ou une iframe. (Un document enfant peut accéder à ces propriétés dans le document parent du moment qu’il se trouve dans le même sandbox de sécurité. Par exemple, un document chargé dans un cadre pourrait accéder à la propriété
runtime
de son parent au moyen de
parent.runtime
.)
