Finestra di condivisione

La finestra di condivisione consente alle persone di pubblicare singole notizie sul proprio diario, su quello di un amico, su un gruppo o in un messaggio privato su Messenger. La finestra di condivisione non richiede Facebook Login o autorizzazioni avanzate, pertanto si tratta del modo più semplice per abilitare la condivisione sul web.

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.

Nell'immagine precedente, l'opzione Condividi sul tuo diario è stata selezionata nel menu a discesa per scegliere il pubblico per la condivisione. Il menu a discesa per scegliere il pubblico non appare a chi sta navigando su un browser da cui non è stato effettuato l'accesso con un cookie. Lo stesso accade se l'app usa la finestra di dialogo delle Notizie invece della finestra di condivisione o se usa una visualizzazione web iframe.

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.

Parametro	Descrizione	Obbligatorio?
`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`~~ Obsoleto	~~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`~~ Obsoleto	~~`true` per aprire la finestra di condivisione in un iframe nella parte superiore del sito web. Questa opzione è disponibile solo per cellulari, non per computer~~	~~`false`~~

Dati di risposta

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

Parametro	Descrizione
`error_message`	Un messaggio di errore.

Altri contenuti da consultare

Best practice per la condivisione