分享对话框

用户可以通过分享对话框向自己的时间线、好友的时间线、小组发布单条动态，或在 Messenger 中的私信中发布。分享对话框不需要 Facebook 登录或任何其他权限，因此是实现网络分享最轻松的方法。

本文档介绍如何在网站上实现分享对话框。如要在移动应用中实现分享对话框，请参阅在 iOS 平台分享和在 Android 平台分享。

以下是向用户时间线分享链接的分享对话框示例。

上图中，在用于选择分享受众的下拉列表中选择的是分享到自己的时间线。当用户使用未以 Cookie 登录的浏览器时，用于选择分享受众的下拉列表不会出现。如果应用使用动态发布对话框而不是分享对话框，或者应用使用 iframe 网页视图，则情况也是如此。

如果您是分享到 Facebook 的某个网页的网站管理员，则可添加开放图谱元标签，以便自定义分享给 Facebook 的动态。请务必使用开放图谱标签标记您的网站，以管理内容在 Facebook 上的显示方式。有关详细信息，请参阅网站管理员分享指南。

使用网址重定向分享

如要使用网址重定向分享链接，请使用以下代码。为便于阅读，已添加换行符。使用此代码时，请移除这些换行符。

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

使用 JavaScript 版 Facebook SDK 分享

可以使用包含 share 方法参数的 FB.ui 函数，在 JavaScript 版 Facebook SDK 中提供分享对话框。用以下代码片段打开分享对话框。

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

亲身体验一下吧！

参数

以下是分享对话框的参数。

参数	描述	是否为必要项？
`app_id`	应用的独立标识符。	是。在使用 SDK 时自动提供。
`display`	分享对话框呈现方式。网址重定向 – `display` 值为 `page`。分享对话框在 Facebook.com 内全页显示。 JavaScript 版 Facebook SDK – 显示值是以下值之一：对于已登录应用的用户，为模态框 `iframe` 在 Facebook.com 中的游戏内使用时，为 `async` 对于其他用户，为 `popup` 使用 JavaScript 版 Facebook SDK 时，如有必要，也可强制使用 `popup` 类型。移动网站应用 – `display` 值始终为 `touch`。 iOS 版或 Android 版 Facebook – SDK 自动指定 `display`，并为设备选择相应显示类型。	是。在使用 SDK 时自动提供。
`hashtag`	要添加到分享内容中的话题标签。用户可以在分享对话框中移除此话题标签。话题标签中必须有 # 符号，例如 `#facebook`。默认值为 `null`。	否
`href`	要分享的链接。默认值为当前网址。	在使用 SDK 时为必要项。
~~`redirect_uri`~~ 已停用	~~用户点击分享对话框中的按钮后要重新定向到的网址。~~	~~是。在使用 SDK 时自动提供。~~
~~`mobile_iframe`~~ 已停用	~~设为 `true`，则将在网站上方以 iframe 窗口的形式打开分享对话框。此选项仅适用于移动设备，不适用于桌面设备~~	~~`false`~~

响应数据

只有当用户已使用 Facebook 登录功能登录到您的应用中，才会出现响应。

参数	描述
`error_message`	错误消息。

另请参阅

分享最佳实践