「分享」對話框

用戶可以使用「分享」對話框,在自己的生活時報中發佈個人動態。本文件會介紹如何在網絡上執行「分享」對話框。若要在流動應用程式執行「分享」對話框,請參閱在 iOS 分享在 Android 分享的相關指南。

下方範例展示如何在「分享」對話框分享連結至用戶的生活時報。

如果您是分享至 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

錯誤訊息。