分享對話方塊

「分享」對話方塊能讓用戶將個人動態發佈至自己的動態時報。本文件說明在網頁上實作「分享」對話方塊的方式。若要在行動應用程式中實作「分享」對話方塊,請參閱在 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。「分享」對話方塊是出現在 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

錯誤訊息。