如需了解如何加载和初始化 Javascript 版 Facebook SDK,请参阅快速入门指南。快速入门指南指导用户在初始化 SDK 时,使用常用默认值设置可用选项,但您也可以自定义其中某些选项。
支持的浏览器
JavaScript 版 Facebook SDK 支持以下热门浏览器的两个最新版本:Chrome、Firefox、Safari(包括 iOS)和 Internet Explorer(仅支持 11 版本)。
在基本设置代码片段中,已初始化 en_US
版 SDK,这意味着您站点使用的 Facebook 生成的所有按钮和插件均使用美国英语。(但是,登录对话框等由 Facebook 生成的弹出对话框使用的是用户在 Facebook 上选择的语言,即使与您选择的语言不同,也是如此。)您可以通过更改代码片段中的 src
值来更改此语言。如需了解可以使用的不同语言,请参阅本地化。例如,如果您的站点使用西班牙语,则使用以下代码加载 SDK 后,所有社交插件都会以西班牙语显示。
<script async defer crossorigin="anonymous" src="https://connect.facebook.net/es_LA/sdk.js"></script>
如果在 FB.init()
调用中将 status
设置为 true
,则 SDK 一经初始化,即会尝试获取当前用户的相关信息。如果使用 Facebook 登录,此操作可减少查看登录用户状态的时间,但此操作不适用于其中只有社交插件的公共主页。
您可以使用 FB.getLoginStatus
获取用户的登录状态。如需了解更多信息,请参阅通过 JavaScript SDK 使用 Facebook 登录。
将 xfbml
设置为 true
时,SDK 会解析公共主页的 DOM,以找到并初始化使用 XFBML 添加的所有社交插件。如果未在公共主页中使用社交插件,则将 xfbml
设置为 false
将缩短页面加载时间。如需更多相关信息,请参阅社交插件。
在 SDK 完成加载后,系统会立即运行分配给 window.fbAsyncInit
的函数。要在加载 SDK 后运行的所有代码均应加入此函数中,并应置于 FB.init
调用之后。在此可以使用各种 JavaScript,但必须在调用 FB.init
后才能调用 SDK 函数。
为提高性能,需加载极简化 JavaScript SDK。此外,也可以加载调试版 JavaScript SDK,这一版的记录更多,参数检查更严格,但无需减少其加载频次。为此,可将加载代码中的 src
值更改为以下值:
src="https://connect.facebook.net/en_US/sdk/debug.js"
调试版本不能用于生产环境,因为其负载更大,并且更不利于提高公共主页的性能。
如需可用初始化选项的完整列表,请参阅 FB.init
函数的参考文档。