Boîte de dialogue Partager

La boîte de dialogue Partager donne à chacun·e la possibilité de publier une actualité sur son journal, sur le journal d’un·e de ses ami·es, dans un groupe ou dans un message privé envoyé sur Messenger. La boîte de dialogue Partager ne nécessite pas d’avoir Facebook Login ni d’autorisations étendues. Il s’agit donc du moyen le plus simple d’activer le partage sur le Web.

Cette documentation décrit comment implémenter la boîte de dialogue Partager sur le Web. Pour implémenter la boîte de dialogue Partager dans une application mobile, consultez Partage sur iOS et Partage sur Android.

Voici un exemple de boîte de dialogue Partager qui partage un lien vers le journal d’un·e utilisateur·trice.

Sur l’image précédente, Partager sur votre propre journal est sélectionné dans la liste déroulante pour choisir l’audience concernée par le partage. Cette liste déroulante n’apparaît pas lorsqu’une personne est sur un navigateur non connecté avec un cookie. C’est également le cas si l’application utilise la boîte de dialogue de Fil au lieu de la boîte de dialogue Partager ou si l’application utilise la vue Web iframe.

Si vous êtes le ou la webmaster d’une page partagée avec Facebook, ajoutez les tags méta Open Graph pour personnaliser l’actualité repartagée avec Facebook. Il est essentiel de marquer votre site Web avec les tags Open Graph pour gérer la disposition de votre contenu sur Facebook. Pour plus d’informations, consultez le Guide du partage pour les webmasters.

Partager à l’aide de la redirection d’URL

Pour partager un lien à l’aide de la redirection d’URL, utilisez le code suivant. Des sauts de ligne sont inclus pour faciliter la lecture. Supprimez-les si vous utilisez ce code.

https://www.facebook.com/dialog/share?
  app_id=145634995501895
  &display=popup
  &href=https%3A%2F%2Fdevelopers.facebook.com%2Fdocs%2F
  &redirect_uri=https%3A%2F%2Fdevelopers.facebook.com%2Ftools%2Fexplorer

Partager à l’aide du SDK Facebook pour JavaScript

La boîte de dialogue Partager est disponible dans le SDK Facebook pour JavaScript à l’aide de la fonction FB.ui et le paramètre de méthode share. Utilisez l’extrait de code suivant pour ouvrir la boîte de dialogue Partager.

FB.ui({
  method: 'share',
  href: 'https://developers.facebook.com/docs/',
}, function(response){});

Essayez vous-même !

Paramètres

Voici les paramètres pour la boîte de dialogue Partager.

Paramètre	Description	Obligatoire ?
`app_id`	Identifiant unique de votre application.	Oui. Fourni automatiquement lorsque vous utilisez le SDK.
`display`	Affichage de la boîte de dialogue Partager. Redirection d’URL - La valeur `display` est `page`. La boîte de dialogue Partager s’affiche sous forme de page entière dans Facebook.com. SDK Facebook pour JavaScript - La valeur d’affichage est l’une des suivantes : un `iframe` modal pour les personnes connectées à votre application `async` lors de l’utilisation dans un jeu sur Facebook.com une fenêtre `popup` pour toutes les autres personnes Si nécessaire, vous pouvez forcer l’utilisation du type `popup` lorsque vous utilisez le SDK Facebook pour JavaScript. Applications Web mobiles - La valeur `display` est toujours `touch`. SDK Facebook pour iOS ou Android - Le SDK spécifie `display` automatiquement et sélectionne un type d’affichage approprié pour l’appareil.	Oui. Fourni automatiquement lorsque vous utilisez le SDK.
`hashtag`	Hashtag à ajouter au contenu partagé. Les utilisateur·ices peuvent supprimer le hashtag dans la boîte de dialogue Partager. Le hashtag doit inclure le symbole dièse, par exemple `#facebook`. La valeur par défaut est `null`.	Non
`href`	Lien à partager. La valeur par défaut est l’URL actuelle.	Obligatoire lorsque vous utilisez le SDK.
~~`redirect_uri`~~ Abandonné	~~URL vers laquelle une personne est redirigée après avoir cliqué sur un bouton de la boîte de dialogue Partager.~~	~~Oui. Fourni automatiquement lorsque vous utilisez le SDK.~~
~~`mobile_iframe`~~ Abandonné	~~`true` pour ouvrir la boîte de dialogue Partager dans un iframe en haut de votre site Web. Cette option est disponible uniquement sur la version pour les mobiles, pas pour les ordinateurs de bureau~~	~~`false`~~

Données de réponse

Une réponse est générée uniquement si l’utilisateur·ice est connecté·e à votre application à l’aide de Facebook Login.

Paramètre	Description
`error_message`	Message d’erreur.

Voir aussi

Recommandations relatives au partage sur Facebook