分享對話方塊

「分享」對話方塊能讓用戶將個人動態發佈至自己的動態時報、朋友的動態時報、社團，或者 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

使用 Facebook JavaScript SDK 分享

使用 FB.ui 函式加上 share 方法參數，就能在 Facebook JavaScript SDK 中使用「分享」對話方塊。使用下列程式碼片段即可開啟「分享」對話方塊。

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

自己動手嘗試！

參數

下列是「分享」對話方塊的參數。

參數	說明	是否必要？
`app_id`	應用程式的唯一識別碼。	是。當您使用 SDK 時會自動提供。
`display`	「分享」對話方塊轉譯方式。網址重新導向 – `display` 值是 `page`。「分享」對話方塊是出現在 Facebooke.com 中的完整頁面。 Facebook JavaScript SDK – 顯示值是下列其中一項：強制回應 `iframe`：向應用程式登入用戶顯示 `async`：在 Facebook.com 的遊戲中使用時 `popup` 視窗：向其他所有人顯示如有必要，您可以在使用 Facebook JavaScript SDK 時強制使用 `popup` 類型。行動版網頁應用程式 – `display` 值一律是 `touch`。 Facebook iOS SDK 或 Facebook Android SDK – SDK 會自動指定 `display` 並依據裝置選擇適當顯示類型。	是。當您使用 SDK 時會自動提供。
`hashtag`	新增至分享內容的主題標籤。用戶可以移除「分享」對話方塊中的主題標籤。主題標籤應包含主題符號，例如 `#facebook`。預設值是 `null`。	否
`href`	要分享的連結。預設值是目前的網址。	使用 SDK 時必須提供。
~~`redirect_uri`~~ 停用項目	~~用戶點擊「分享」對話方塊上的按鈕後，會重新導向至這個網址。~~	~~是。當您使用 SDK 時自動提供。~~
~~`mobile_iframe`~~ 停用項目	~~`true` 會在網站頂端的 iframe 中開啟「分享」對話方塊。此選項只適用於行動版，不適用於桌面版~~	~~`false`~~

回應資料

用戶必須使用「Facebook 登入」登入您的應用程式，回應功能才作用。

參數	說明
`error_message`	錯誤訊息。

另請參閱

分享的最佳作法