Прочтите наше руководство по началу работы и узнайте, как загрузить и инициализировать Facebook SDK для JavaScript. Для параметров, доступных на момент инициализации SDK, в руководстве используются значения по умолчанию, но вы можете настроить некоторые из них.
Поддерживаемые браузеры
Facebook SDK для JavaScript поддерживает по две последние версии самых популярных браузеров: Chrome, Firefox, Edge, Safari (в том числе на устройствах с iOS) и Internet Explorer (только версия 11).
В базовом фрагменте кода для настройки инициализируется версия SDK en_US
. Это означает, что все генерируемые 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
. Подробнее об использовании входа через Facebook с SDK для JavaScript см. в этом разделе.
Если для xfbml
установлено значение true
, SDK проанализирует модель DOM на вашей странице и инициализирует социальные плагины, добавленные с использованием XFBML. Если вы не используете на странице социальные плагины, установите для xfbml
значение false
, чтобы ускорить загрузку. Подробнее об этом см. в разделе Социальные плагины.
Функция, назначенная window.fbAsyncInit
, запускается сразу же после загрузки SDK. Если вы хотите выполнить какой-то код после загрузки SDK, поместите его в эту функцию после вызова FB.init
. Здесь можно использовать любой код JavaScript, но все функции SDK можно вызывать только после FB.init
.
Чтобы повысить производительность, SDK для JavaScript загружается в минифицированном виде. Для отладки можно загрузить неминифицированную версию SDK для JavaScript, в которой используется больше уровней журналов и более строгая проверка аргументов. Чтобы это сделать, замените значение src
в коде загрузки следующим образом:
src="https://connect.facebook.net/en_US/sdk/debug.js"
Версию для отладки не следует использовать для полноценной работы. Ее полезная нагрузка больше, что негативно скажется на производительности страницы.
В справке по функции FB.init
приведен полный список доступных параметров инициализации.