Finestra di condivisione

La finestra di condivisione offre alle persone la possibilità di pubblicare una singola storia sul proprio diario. Questa documentazione descrive come implementare la finestra di condivisione sul web. Per implementare la finestra di condivisione in un'app mobile, consulta Condivisione su iOS e Condivisione su Android.

Quello che segue è un esempio della finestra condivisione usata per condividere un link sul diario di un utente.

Se lavori come webmaster per una pagina condivisa su Facebook, includi i metatag di Open Graph per personalizzare la notizia condivisa su Facebook. È importante effettuare il markup dell'HTML del sito web con i tag di Open Graph per gestire il modo in cui il contenuto viene visualizzato su Facebook. Per maggiori informazioni, consulta Guida alla condivisione per i webmaster.

Condividere con il reindirizzamento dell'URL

Per condividere un link usando il reindirizzamento dell'URL, usa il codice qui sotto. Sono inclusi dei ritorni a capo per facilitare la lettura. Rimuovi i ritorni a capo quando usi questo codice.

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

Condividere usando l'SDK di Facebook per JavaScript

La finestra di condivisione è disponibile nell'SDK di Facebook per JavaScript, usando la funzione FB.ui con il parametro di metodo share. Usa il seguente snippet di codice per aprire la finestra di condivisione.

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

Parametri

Quelli che seguono sono i parametri della finestra di condivisione.

ParametroDescrizioneObbligatorio?

app_id

L'identificativo unico della tua app.

Sì. Fornito automaticamente quando usi l'SDK.

display

Determina il modo in cui viene visualizzata la finestra di condivisione.

  • Reindirizzamento dell'URL; il valore display è page. La finestra di condivisione è una pagina intera che appare all'interno di Facebook.com.

  • SDK di Facebook per JavaScript; il valore display è uno dei seguenti:

    • un iframe modale per le persone che hanno effettuato l'accesso alla tua app;
    • async se usato all'interno di un gioco su Facebook.com;
    • una finestra popup in tutti gli altri casi.

    Se necessario, puoi forzare il tipo popup quando usi l'SDK di Facebook per JavaScript.

  • App web mobile; il valore display è sempre touch.

  • SDK di Facebook per iOS o Android; l'SDK specifica display automaticamente e sceglie automaticamente un tipo di visualizzazione adatto per il dispositivo.

Sì. Fornito automaticamente quando usi l'SDK.

hashtag

Un hashtag da aggiungere ai contenuti condivisi. Le persone possono rimuovere l'hashtag nella finestra di condivisione. L'hashtag deve includere il simbolo cancelletto, ad esempio #facebook. Il valore predefinito è null.

No

href

Il link da condividere. Il valore predefinito è l'URL attuale.

Obbligatorio quando si usa l'SDK.

redirect_uri

Elementi obsoleti

L'URL a cui viene reindirizzata la persona dopo aver cliccato su un pulsante della finestra di condivisione.Sì. Fornito automaticamente quando usi l'SDK.
mobile_iframe

Elementi obsoleti

true per aprire la finestra di condivisione in un iframe nella parte superiore del sito web. Questa opzione è disponibile solo per cellulari, non per computerfalse

Dati di risposta

La risposta si verifica solo se l'utente ha effettuato l'accesso alla tua app usando Facebook Login.

ParametroDescrizione

error_message

Un messaggio di errore.

Altri contenuti da consultare