Comment partager un lien (HTML)

Article
12/11/2015

[ Cet article est destiné aux développeurs de 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 liens, ou URI (Uniform Resource Identifier), sont un autre format de données courant que les utilisateurs aiment partager. Le partage d’un lien intervient principalement en réponse à la sélection d’un lien spécifique par un utilisateur. Toutefois, nous recommandons que votre application prenne aussi en charge le partage des liens :

lorsque le contenu sélectionné par l’utilisateur est également disponible en ligne ;
en tant que deuxième source lors du partage de contenu HTML.

Ce que vous devez savoir

Technologies

Windows.ApplicationModel.DataTransfer

Prérequis

Vous devez être familiarisé avec Visual Studio et ses modèles connexes.
Vous devez être familiarisé avec JavaScript.

Instructions

Étape 1: obtenir l’objet DataTransferManager

L’objet DataTransferManager est le point de départ de toute opération de partage.

var dataTransferManager = Windows.ApplicationModel.DataTransfer.DataTransferManager.getForCurrentView();
    dataTransferManager.addEventListener("datarequested", shareAsyncHandler);

Étape 2: ajouter un gestionnaire d’événements pour l’événement datarequested

Ajoutez un gestionnaire d’événements DataRequested qui se déclenche quand l’utilisateur souhaite appeler le partage. Dans une application du Windows Store, cela se produit automatiquement quand l’utilisateur appelle l’icône Partager. Si vous développez une application pour Windows Phone, aucune icône Partager n’est intégrée, donc vous devez ajouter un contrôle sur lequel l’utilisateur peut appuyer pour déclencher le gestionnaire.

dataTransferManager.addEventListener("datarequested", function (e) {
    // Code to handle event goes here.
});

Étape 3: obtenir un objet DataRequest

Lorsqu’un événement datarequested survient, votre application reçoit un objet DataRequest. Cet objet contient une classe DataPackage que vous pouvez utiliser pour fournir le contenu qu’un utilisateur souhaite partager.

var request = e.request;

Étape 4: ajouter le lien à l’objet DataPackage

Pour ajouter le lien, utilisez la méthode setUri.

request.data.setUri(new Windows.Foundation.Uri("http://www.fabrikam.com"));

Remarques

Pour les applications qui partagent un URI de protocole d’activation, ajoutez des informations supplémentaires au DataPackage, en plus de l’URI. Cela aide à garantir que les applications cibles procurent une expérience supérieure à tous les utilisateurs, y compris ceux qui utilisent un autre système d’exploitation (SE).

Fournissez un bon titre et une bonne description du contenu.
Incluez un extrait de code HTML décrivant le contenu partagé, et qui inclut l’URI inline. Nous vous recommandons d’inclure une chaîne qui souligne que le lien fonctionne pour les utilisateurs Windows 8 et de fournir, si possible, un lien Web supplémentaire pour les utilisateurs utilisant un autre système d’exploitation (SE).
Incluez une version textuelle de votre extrait de code HTML.

Certaines applications cibles peuvent indiquer qu’elles prennent en charge les URI même si elles ne gèrent en réalité que les URI http:// ou https://. Fournir des formats de données alternatifs améliore les chances de l’application cible d’effectuer votre scénario.

Terminer l’exemple

Voici un exemple d’une fonction qui définit un lien qu’un utilisateur souhaite partager. Pour obtenir un exemple plus complet, voir l’exemple de notre bibliothèque de code.

function registerForShare() {
    var dataTransferManager = Windows.ApplicationModel.DataTransfer.DataTransferManager.getForCurrentView();
    dataTransferManager.addEventListener("datarequested", shareLinkHandler);
}

function shareLinkHandler(e) {
        var request = e.request;
        request.data.properties.title = "Share Link Example";
        request.data.properties.description = "A demonstration that shows how to add a link (URI) to share.";
        request.data.setUri(new Windows.Foundation.Uri("http://www.fabrikam.com"));
}