Langage: HTML | XAML

Comment charger des ressources de fichiers (HTML)

Applies to Windows and Windows Phone

Apprenez à charger les ressources de fichier à partir de différents emplacements.

Vous pouvez accéder aux ressources regroupées dans des fichiers de l’application que vous livrez sous forme intégrée dans un package, aux ressources que vous incluez dans un kit de développement logiciel (SDK) ou un package d’infrastructure, ou encore aux ressources tirées de l’état de l’application ou du Web. Vous pouvez faire référence à ces fichiers sous forme de code à balises (par exemple en HTML ou XML des notifications) ou par le biais de code (tel que XmlHttpRequest ou des storage file APIs). Les exemples repris ici montrent les ressources de fichiers sous des contextes particuliers, mais vous pouvez en utiliser la plupart dans divers autres contextes.

Web

Pour accéder aux fichiers depuis le Web, vous pouvez faire appel à des URI HTTP absolues standard.

<img src="http://www.contoso.com/images/logo.png" alt="Logo" />

Package d’application

Lors de l’accès aux fichiers depuis le package de votre application, vous pouvez utiliser un chemin d’accès direct ou logique pour faire référence à la ressource. Cela reste vrai même si les fichiers font état de plusieurs variantes de langues, d’échelles, de contrastes ou d’autre nature. Pour obtenir une présentation, voir Démarrage rapide : utilisation de ressources de fichiers ou d’images.

Par exemple, pour charger

Images/en-US/homeregion-USA/logo.scale-100_contrast-white.png

en faisant référence à

Images/logo.png

Pour accéder relativement à des fichiers par rapport à un document actif, vous pouvez utiliser des URI relatifs.

<img src="images/logo.png" />

Pour accéder relativement à des fichiers par rapport à la racine du package, vous pouvez utiliser des URI de chemin d’accès absolus (commençant par "/").

<img src="/images/logo.png" />

Pour accéder à des fichiers stockés au sein du même package mais émanant d’une bibliothèque de classes, utilisez le nom de cette dernière :

<img src="/ClassLibraryName/images/logo.png" />

Pour accéder aux fichiers stockés à l’intérieur du package de l’application mais à partir de code ne comprenant aucune URI de document de base, spécifiez le schéma « ms-appx: ».


var uri = new Windows.Foundation.Uri('ms-appx:///images/logo.png');
var file = Windows.Storage.StorageFile.getFileFromApplicationUriAsync(uri);

Pour accéder aux fichiers stockés dans un package d’infrastructure, utilisez une URI absolue.

<script src="ms-appx://Microsoft.WinJS.1.0/js/ui.js"></script>

Pour accéder aux fichiers à charger dans le compartiment Web, faites appel au schéma « ms-appx-web: ».

<iframe src="ms-appx-web:///html/webcompartment.html"></iframe>

Pour accéder aux fichiers dans le même compartiment Web ou local que le document actif, ne spécifiez aucun schéma.

<script src="//Microsoft.WinJS.1.0/js/ui.js"></script>

État de l’application

Pour accéder à des fichiers stockés dans l’état de l’application, utilisez le schéma « ms-appdata: ». Il se peut que l’état de l’application soit stocké dans un dossier local, dans un dossier itinérant ou dans un dossier temporaire.

Pour accéder à des fichiers stockés dans le dossier local :

<img src="ms-appdata:///local/images/logo.png" />

Pour accéder à des fichiers stockés dans le dossier itinérant :

<img src="ms-appdata:///roaming/images/logo.png" />

Pour accéder à des fichiers stockés dans le dossier temporaire :

<img src="ms-appdata:///temp/images/logo.png" />

Les storage file APIs peuvent accéder de la même manière aux fichiers se trouvant dans le package d’application :


var uri = new Windows.Foundation.Uri('ms-appdata:///local/images/logo.png');
var file = Windows.Storage.StorageFile.getFileFromApplicationUriAsync(uri);

Événements et changements de contexte

Votre application se charge au besoin de l’actualisation de l’affichage de ses ressources.

Des applications du Windows Store peuvent être en cours d’exécution lors des changements apportés au système, notamment lorsque l’utilisateur active le mode Contraste élevé. Cela entraîne l’usage d’un ensemble différent de qualificateurs par l’application. Divers changements système appellent des événements dans l’objet ResourceContext.

Dans JavaScript, la méthode la plus simple d’écouter ces événements est via

WinJS.Resources.addEventListener('contextchanged', refresh, false);

Les éléments d’image ne sont pas mis automatiquement à jour quand le contexte change. Il incombe à l’application de remplacer les images. Les demandes de support CSS sont une alternative permettant de mettre à jour immédiatement les propriétés CSS, par exemple background-image.

 

 

Afficher:
© 2015 Microsoft