Diálogo de compartilhamento

Com o diálogo de compartilhamento, as pessoas podem publicar um story individual na linha do tempo. Esta documentação descreve como implementar o diálogo de compartilhamento na web. Para implementar o diálogo de compartilhamento em um app para celular, consulte os guias para iOs e Android.

Veja a seguir um exemplo de diálogo de compartilhamento que publica um link na linha do tempo de um usuário.

Se você for o webmaster de uma página compartilhada no Facebook, inclua metatags do Open Graph para personalizar a história que é compartilhada na plataforma. É importante marcar o site com tags do Open Graph para controlar como seu conteúdo é exibido no Facebook. Para saber mais, consulte Um guia de compartilhamento para webmasters.

Compartilhar usando o redirecionamento de URL

Para compartilhar um link usando o redirecionamento de URL, use o código a seguir. Incluímos quebras de linha para facilitar a leitura. Remova-as quando usar código.

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

Compartilhar usando o SDK do Facebook para JavaScript

O diálogo de compartilhamento é disponibilizado no SDK do Facebook para JavaScript quando você usa a função FB.ui com o parâmetro do método share. Use o trecho de código a seguir para abrir o diálogo de compartilhamento.

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

Experimente!

Parâmetros

Veja a seguir os parâmetros do diálogo de compartilhamento.

Parâmetro	Descrição	Obrigatório?
`app_id`	O identificador único do app.	Sim. Fornecido automaticamente quando você usa o SDK.
`display`	Define como o diálogo de compartilhamento é renderizado. Redirecionamento de URL – O valor de `display` é `page`. O diálogo de compartilhamento é uma página inteira que aparece no site Facebook.com. SDK do Facebook para JavaScript – O valor de exibição é um dos seguintes: Um `iframe` modal para pessoas que entraram no seu app `async` quando incluído em um jogo no site Facebook.com Uma janela `popup` para todos os outros Se for necessário, é possível forçar o tipo `popup` ao usar o SDK do Facebook para JavaScript. Apps de web móvel – O valor de `display` é sempre `touch`. SDK do Facebook para iOS ou Android – O SDK especifica `display` automaticamente e escolhe um tipo de exibição apropriado para o dispositivo.	Sim. Fornecido automaticamente quando você usa o SDK.
`hashtag`	Representa uma hashtag para adicionar ao conteúdo compartilhado. As pessoas podem remover a hashtag no diálogo de compartilhamento. A hashtag deve incluir o símbolo de hash, por exemplo `#facebook`. O valor-padrão é `null`.	Não.
`href`	Representa o link para compartilhar. O valor-padrão é o URL atual.	É necessário quando você usa o SDK.
~~`redirect_uri`~~ Obsoleto	~~Representa o URL para a qual uma pessoa será redirecionada depois de clicar em um botão no diálogo de compartilhamento.~~	~~Sim. Fornecido automaticamente quando você usa o SDK.~~
~~`mobile_iframe`~~ Obsoleto	~~`true` para abrir o diálogo de compartilhamento em um iframe na parte superior do seu site. Esta opção está disponível apenas para dispositivos móveis, não para desktop.~~	~~`false`~~

Dados de resposta

Haverá uma resposta somente se o usuário tiver entrado no seu app usando o Login do Facebook.

Parâmetro	Descrição
`error_message`	Representa uma mensagem de erro.

Veja também

Boas práticas