JavaScript용 Facebook SDK를 읽어들이고 초기화하는 방법에 대해 알아보려면 빠른 시작 가이드를 참조하세요. 빠른 시작에서는 JavaScript용 Facebook SDK를 초기화할 때 사용할 수 있는 옵션의 일반적인 기본값을 사용하지만 몇 가지 옵션은 직접 설정할 수 있습니다.
지원되는 브라우저
JavaScript용 Facebook SDK는 가장 인기 있는 브라우저 (Chrome, Firefox, Edge, Safari(iOS 포함), Internet Explorer(11 버전만 해당))의 최신 버전 2개를 지원합니다.
기본 설정 코드 조각에서 JavaScript용 Facebook 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
를 사용하여 사용자의 로그인 상태를 가져올 수 있습니다. JavaScript SDK와 Facebook 로그인 사용하기에 대한 자세한 내용을 읽어 보세요.
xfbml
을 true
로 설정하면 SDK가 페이지의 DOM을 파싱하고 XFBML로 추가한 모든 소셜 플러그인을 찾아서 초기화합니다. 페이지에서 소셜 플러그인을 사용하지 않을 경우 xfbml
을 false
로 설정하면 페이지를 읽어들이는 시간이 단축됩니다. 자세한 내용은 소셜 플러그인에서 확인할 수 있습니다.
window.fbAsyncInit
에 할당된 함수는 SDK를 읽어들이는 즉시 실행됩니다. SDK를 읽어들인 후에 실행하고자 하는 코드는 모두 이 함수 내부에서 FB.init
을 호출한 뒤에 넣어야 합니다. 여기에서는 모든 종류의 JavaScript를 사용할 수 있지만 모든 SDK 함수는 반드시FB.init
이후에 호출해야 합니다.
성능을 개선하기 위해 JavaScript SDK는 최소화된 상태에서 읽어들입니다. 최소화되지 않은 상태에서 더 많은 로깅과 더욱 엄격한 인수 검사를 포함한 JavaScript SDK의 디버그 버전을 읽어들일 수도 있습니다. 이렇게 하려면 읽어들이는 코드에서 src
값을 다음과 같이 변경합니다.
src="https://connect.facebook.net/en_US/sdk/debug.js"
디버그 버전은 페이로드가 더 크고 페이지의 성능에 부정적인 영향을 미치므로 프로덕션 환경에서 사용해서는 안 됩니다.
FB.init
함수의 참고 자료는 사용 가능한 초기화 옵션의 전체 리스트를 제공합니다.