Modèles d’élément JavaScript
Réduire la table des matières
Développer la table des matières

Modèles d’élément JavaScript pour les applications du Windows Store

[ Cet article est destiné aux développeurs Windows 8.x et Windows Phone 8.x qui créent des applications Windows Runtime. Si vous développez une application pour Windows 10, voir la Documentation ]

Les modèles d’élément sont des fichiers d’application contenant du code couramment utilisé qui peut être ajouté à un modèle de projet afin de réduire le temps de développement.

Important  Les informations présentées dans cette rubrique s’appliquent à Windows Phone 8, Windows 8.1 Update et Microsoft Visual Studio 2013 Update 2. Pour plus d’informations sur les modèles Windows 8.1, voir la section dédiée aux modèles d’application universelle dans Modèles de projet JavaScript et Portage de votre application Windows Runtime sur Windows Phone.
 

Les modèles d’élément pour les applications du Windows Phone Store et du Windows Store contiennent les références et les balises de script appropriées pour la prise en charge de la Bibliothèque Windows pour JavaScript. Certains modèles d’élément implémentent un contrat, qui est semblable à un accord entre une ou plusieurs applications pour utiliser des API spécifiques. Quand vous ajoutez un modèle de contrat (Contrat de sélecteur d’ouverture de fichier ou Contrat de partage cible), le manifeste de l’application est mis à jour avec les déclarations appropriées. Vous pouvez voir les paramètres de ces déclarations sous l’onglet Déclarations du concepteur du manifeste.

Vous pouvez ajouter un modèle d’élément à un projet existant en ouvrant le menu contextuel du projet dans l’Explorateur de solutions, puis en choisissant Ajouter > Nouvel élément.

Pour des informations sur les modèles d’élément pour d’autres langages, voir Modèles d’élément C#, VB, et C++.

Modèle d’élément Contrôle de page pour les applications du Store

Ce modèle d’élément fournit le contenu et le balisage requis pour une page dans votre application. Le balisage HTML inclut une section d’en-tête comportant un bouton Précédent et une section de contenu principal.

Lorsque vous incluez un modèle d’élément Contrôle de page, Visual Studio ajoute trois fichiers à votre projet :

  • un fichier HTML (appelé pagecontrol.html par défaut), qui contient une section d’en-tête et une section de contenu principal pour votre page ;
  • un fichier JavaScript qui fournit le code nécessaire à la prise en charge de la page. Ce fichier contient le code qui permet de prendre en charge le modèle de navigation recommandé pour les applications du Windows Store.
  • un fichier CSS qui spécifie les styles CSS pour la page.

Le modèle de navigation utilisé dans le modèle d’élément Contrôle de page est également implémenté dans les modèles de projet Hub/Pivot, Hub, Pivot, Grille, Fractionner et Navigation. Nous vous recommandons d’utiliser ce modèle d’élément lorsque vous ajoutez des pages à ces modèles de projet. Pour plus d’informations, voir Démarrage rapide : utilisation de la navigation sur une seule page et la section « Modèle de navigation » dans Modèles de projet JavaScript.

Attention  Pour utiliser le modèle d’élément Contrôle de page avec le modèle Vide, vous devez ajouter navigator.js au projet et le code hôte du contenu à default.html (vous pouvez obtenir navigator.js et le code hôte du contenu à partir d’un autre modèle de projet, tel que Hub/Pivot).
 

Modèle d’élément Contrat de partage cible pour les applications du Store

Le modèle d’élément Contrat de partage cible permet à une application de coordonner le partage de données entre d’autres applications. Par exemple, vous pouvez utiliser ce modèle pour permettre aux utilisateurs de publier une photo sur Facebook à partir de Flickr. Ce modèle inclut le code permettant à l’application de recevoir du contenu partagé. L’application contenant ce modèle d’élément démarre lorsqu’elle est sélectionnée dans l’interface utilisateur de partage.

Lorsque vous incluez un modèle d’élément Contrat de partage cible, Visual Studio ajoute trois fichiers à votre projet :

  • un fichier HTML (appelé shareTarget.html par défaut), qui s’affiche lorsque l’application est sélectionnée dans l’interface utilisateur de partage ;
  • un fichier JavaScript qui fournit le code nécessaire à la gestion du contenu partagé ;
  • un fichier CSS qui spécifie les styles pour la page.

La page HTML inclut une section de contenu principal qui comporte le balisage requis pour afficher une partie minimale du contenu partagé : un élément IMG pour une image miniature partagée, un titre et une description pour les propriétés partagées, et une zone de texte standard dans laquelle l’utilisateur peut ajouter des commentaires lors du traitement du contenu partagé.

Le code JavaScript utilise l’événement activated pour vérifier si l’application est activée pour recevoir des données partagées, puis il utilise l’objet ShareOperation pour accéder à ces données et définir les propriétés initiales du modèle (à savoir, le titre, la description et l’image miniature). Utilisez la fonction onShareSubmit dans le fichier JavaScript pour traiter les données partagées en même temps que les commentaires.

Pour plus d’informations sur les contrats de partage, voir Démarrage rapide : réception de contenu partagé.

Modèle d’élément Page Résultats de la recherche pour les applications du Store

Ce modèle d’élément permet à une application de présenter une page de résultats pour une recherche exécutée à partir du contrôle WinJS.UI.SearchBox.

Remarque : le modèle d’élément permettant d’effectuer des recherches dans Microsoft Visual Studio 2013 n’implémente plus de contrat. Le nom du modèle d’élément a été également modifié (à partir du contrat de recherche).

Quand vous incluez un modèle d’élément Page Résultats de la recherche, Visual Studio ajoute trois fichiers à votre projet :

  • un fichier HTML (appelé searchResults.html par défaut), qui contient un contrôle ListView pour afficher les résultats de recherche ;
  • un fichier JavaScript qui fournit le code nécessaire à la prise en charge de la page de recherche. Le fichier source contient le code qui permet de prendre en charge le modèle de navigation recommandé pour les applications du Windows Store.
  • un fichier CSS qui spécifie les styles CSS pour la page de recherche.

Le modèle de navigation utilisé dans le modèle d’élément est également implémenté dans les modèles de projet Hub, Grille, Fractionner et Navigation. Nous vous recommandons d’utiliser ce modèle d’élément quand vous ajoutez un modèle d’élément Page des résultats de recherche à ces modèles de projet. Pour plus d’informations, voir la section « Modèle de navigation » dans Modèles de projet JavaScript.

La page Résultats de la recherche affiche les résultats de la recherche dans un objet ListView. Cela ressemble beaucoup aux modèles WinJS utilisés dans les modèles de projet Grille et Fractionner. Pour plus d’informations, voir Personnalisation des données dans les modèles Visual Studio ainsi que la section sur les styles CSS dans Modèles de projet JavaScript pour les applications du Windows Store.

Pour plus d’informations, voir Ajout d’un modèle d’élément Résultats de la recherche et Démarrage rapide : ajout d’une fonctionnalité de recherche.

Modèle d’élément Contrat de sélecteur d’ouverture de fichier pour les applications du Store

Le modèle d’élément Contrat de sélecteur d’ouverture de fichier permet à une application d’exposer ses données sous forme de fichiers pour d’autres applications. Par exemple, vous pouvez utiliser ce modèle pour créer une boîte de dialogue de sélection de photos qui permet à l’utilisateur de choisir une photo depuis Facebook, même si la photo n’est pas stockée sur le disque dur local.

Lorsque vous incluez un modèle d’élément Contrat de sélecteur d’ouverture de fichier, Visual Studio ajoute trois fichiers à votre projet :

  • un fichier HTML (appelé fileOpenPicker.html par défaut), qui contient un contrôle ListView pour afficher la liste de fichiers.
  • un fichier JavaScript qui fournit le code nécessaire à la gestion de la sélection d’éléments dans la liste de fichiers ;
  • un fichier CSS qui spécifie les styles pour la page HTML contenant la liste de fichiers.

Le modèle Contrat de sélecteur d’ouverture de fichier affiche la liste de fichiers dans objet ListView. Cela ressemble beaucoup aux modèles WinJS utilisés dans les modèles de projet Grille et Fractionner. Pour plus d’informations, voir Ajout de données dans un modèle de projet ainsi que la section sur les styles CSS dans Modèles de projet JavaScript pour les applications du Windows Store.

Pour plus d’informations sur les contrats de sélecteur d’ouverture de fichier, voir Démarrage rapide : intégration aux contrats du sélecteur de fichiers.

Autres modèles d’élément dans Visual Studio

La plupart des autres modèles d’élément, tels que Page HTML, Fichier JavaScript et Fichier XML, sont des fichiers standard qui ne comportent pas de fonctionnalités spécifiques pour les applications du Windows Store. Voici des informations supplémentaires sur deux des modèles.

Fichier de ressources

Pour faciliter la localisation d’une application du Windows Store, vous pouvez ajouter un ou plusieurs modèles d’élément Fichier de ressources (fichiers .resjson) à votre projet. Pour plus d’informations, voir Globalisation de votre application.

Processus de travail dédié

Si vous utilisez des threads de travail Web HTML5 dans votre application du Windows Store, nous vous recommandons d’ajouter à votre projet un modèle d’élément Processus de travail dédié. Ce modèle d’élément contient une directive de référence permettant la prise en charge IntelliSense pour l’API Web Worker (threads de travail Web). Pour plus d’informations sur l’utilisation des threads de travail Web dans vos applications du Windows Store, voir Threads de travail Web.

Rubriques associées

Modèles de projet JavaScript pour les applications du Windows Store
Ajout d’un modèle d’élément Résultats de la recherche

 

 

Afficher:
© 2016 Microsoft