分享对话框

借助分享对话框,用户可以在其时间线上发布个人动态。本文档介绍如何在网站上实现分享对话框。如要在移动应用中实现分享对话框,请参阅在 iOS 平台分享在 Android 平台分享

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

如果您是要分享到 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

错误消息。

另请参阅