Démarrage rapide : SDK Facebook pour JavaScript

Le SDK Facebook pour JavaScript offre un kit exhaustif de fonctionnalités côté client dont les avantages sont nombreux. Grâce à lui, vous pouvez :

  • Utiliser sur votre site le bouton J’aime et d’autres plugins sociaux.
  • Utiliser Facebook Login pour lever les obstacles et aider les autres à s’inscrire sur votre site.
  • Appeler facilement l’API Graph de Facebook.
  • Lancer la boîte de dialogue permettant aux personnes d’effectuer différentes actions comme celles consistant à partager des stories.
  • Simplifier la communication quand vous créez un jeu ou un onglet d’application dans Facebook.

Ce guide de démarrage rapide vous montrera comment obtenir et configurer le SDK pour réaliser certains appels d’API Graph de base. Si vous ne voulez pas encore passer à l’étape de configuration, vous pouvez utiliser notre Console de test JavaScript pour utiliser l’ensemble des méthodes SDK et découvrir certains exemples (vous pouvez ignorer les étapes de configuration tout en testant dans la console le reste du guide de démarrage).

Navigateurs supportés

Le SDK Facebook pour Javascript supporte les deux dernières versions des navigateurs les plus répandus : Chrome, Firefox, Edge, Safari (dont iOS), et Internet Explorer (version 11 seulement).

Configuration de base

Le SDK Facebook pour JavaScript ne comporte aucun fichier autonome devant être téléchargé ou installé. Vous devez simplement inclure un extrait de code JavaScript habituel dans votre protocole HTML qui chargera le SDK sur vos pages de manière asynchrone. Le chargement asynchrone ne bloque pas le chargement d’autres éléments de votre page.

L’extrait de code ci-dessous fournit la version de base du SDK, dont les paramètres sont réglés sur leurs valeurs courantes par défaut. Nous vous recommandons de l’insérer directement après l’ouverture du tag <body> sur chacune des pages sur lesquelles vous voulez le charger :

<script>
  window.fbAsyncInit = function() {
    FB.init({
      appId            : 'your-app-id',
      xfbml            : true,
      version          : 'v21.0'
    });
  };
</script>
<script async defer crossorigin="anonymous" src="https://connect.facebook.net/en_US/sdk.js"></script>

Ce code chargera et initialisera le SDK. Vous devez remplacer la valeur dans your-app-id par l’ID de votre propre application Facebook. Vous trouverez cet ID dans l’Espace App.