「分享」對話框

「分享」對話框能讓用戶將個人動態發佈至自己的生活時報、朋友的生活時報、群組，或者在 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`。「分享」對話框在 Facebook.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`	錯誤訊息。

另請參閱

分享最佳操作實例