Facebook 嵌入產生器

介紹

Toollect Facebook 嵌入產生器可一鍵將任何公開的 Facebook 貼文、影片或粉絲專頁網址，轉為 Facebook 官方文件記載的 JavaScript SDK 嵌入程式碼 – fb-post / fb-video / fb-page 的 div 加上 sdk.js 載入器，並在複製前先以 Facebook 官方 SDK 渲染即時預覽。

它解決的是許多人手動貼上 Facebook 程式碼時遇過的摩擦。Facebook 的設定工具把粉絲專頁外掛藏得很深，將貼文與影片選項分散在不同頁面，並在 iframe 與 SDK 兩種形式間切換卻不說明取捨。手寫 div 時只要一個 data- 屬性拼錯，貼文就會靜默失效、只剩純連結。這款工具將貼文、影片與粉絲專頁外掛並列呈現，公開每個官方文件的外掛屬性，把你的語言選擇直接寫入載入器網址，並在與訪客相同的瀏覽器中呈現真實渲染結果。

每個程式碼路徑都刻意只走 SDK。SDK 是 Facebook 為三種外掛類型持續維護的格式，是唯一支援顯示語言的格式，也是唯一能讓粉絲專頁外掛分頁與尺寸保持一致的格式。產生器在需要時包含 fb-root 與載入器，在網站已載入 SDK 時則省略，對廣告阻擋器與私密內容誠實反映預覽結果，且絕不會讓你的連結經過 Toollect 伺服器。

使用情境

在部落格文章之外，嵌入 Facebook 內容的場景比想像中更多，三個分頁自然分工。

部落格與編輯內容

引用公開貼文的評論文章、重用爆紅影片的文化報導、將品牌粉絲專頁動態牆作為社交證明嵌入的評測 – 都是典型用途。貼文模式預設 500 像素寬度適用大多數版心，影片模式讓播放器居前，粉絲專頁外掛則無需截圖就能呈現即時動態牆。

新聞編輯室與即時報導

記者將官方聲明與目擊者貼文拉進滾動報導。速度與查核同樣重要 – 產生器會將 m.facebook.com 這類行動分享連結與帶有大量追蹤參數的網址正規化為單一正規參照，預覽則在發稿前確認貼文仍可渲染。

行銷網站與作品集

以嵌入式粉絲專頁動態牆呈現顧客評價、以頁面內播放器呈現發表影片、以卡片呈現公告貼文。語言選擇會以訪客語言渲染外框文字，已載入 Facebook SDK 的頁面省略載入器即可避免重複腳本。

文件與社群網站

引用發表貼文的版本說明、參照 Facebook 社團公告的文件、在活動頁面顯示粉絲專頁的活動分頁。顯示文字與延遲載入控制讓厚重頁面在滾動靠近前保持安靜。

運作方式

工具依五個步驟運作：

1. 解析並分類網址 – 將輸入與 Facebook 連結語法比對：數字 ID 為 5–20 位或 pfbid 形式，使用者名稱 2–50 字元，分頁名稱符合 [a-z][a-z0-9_]*，官方主機為含任意子網域的 facebook.com 以及 fb.watch 與 fb.me。追蹤用查詢鍵會被讀取但在路由時忽略 – 重建的正規網址永遠不會攜帶它們。缺少 ID 的路由如 facebook.com/watch 未帶 v 或 fb.watch 未帶短碼會被拒絕。
2. 選擇外掛類型 – post / photo / group-post 對應貼文，video / reel 對應影片，page 對應粉絲專頁外掛。分頁列會跟隨連結 – 貼上 watch 網址自動切到影片，貼上粉絲專頁網址自動切到粉絲專頁外掛，手動切換分頁時會清空過時輸出而非彈回。
3. 收集你的選項 – 從分頁下拉選單取得語言，從數字欄位取得寬高，從粉絲專頁核取方塊取得分頁與外框，從影片切換取得全螢幕、自動播放與字幕。每次變更都會夾回有效範圍、寫回欄位並立即重新產生。
4. 建構官方標記 – 你的選項會成為 fb-* div 上的 data-* 屬性，粉絲專頁外掛的載入器網址則會以 https://connect.facebook.net/{locale}/sdk.js#xfbml=1&version=v26.0 攜帶你的語言。不會建構 iframe 網址 – SDK 會在解析時直接取用 div 屬性。
5. 渲染預覽 – 產生器將 div 與 fb-root 注入預覽容器，依所選語系載入或重新載入 sdk.js，呼叫 FB.XFBML.parse 並監看產生的 iframe。誠實回報三種結果 – 成功、廣告阻擋器或無法完成渲染。

變更任何選項都會重建整條鏈 – 新屬性、全新的程式碼區塊、重新解析的預覽 – 因此你複製的程式碼永遠與眼前所見一致。

支援的 URL 格式

產生器接受在 Facebook 三個官方主機上能識別公開貼文、影片或粉絲專頁的任何網址形狀，其餘一律以具體訊息拒絕。網址配置與 www. 可省略，行動子網域會被正規化。

接受的格式

結尾斜線、hash 片段與 ID 後的查詢字串會被容忍並丟棄；使用者名稱後如數字分頁段這類顯示後綴會被視為粉絲專頁分頁檢視，而非獨立資源。

拒絕的格式

fb.watch 的情況值得特別說明，因為應用程式分享按鈕至今仍會產生這種形狀。產生器會以專屬的短連結訊息刻意拒絕，並請你開啟連結後複製完整的貼文或影片網址。貼上展開後的網址即可立即成功。

嵌入程式碼結構

輸出即 Facebook 文件記載的程式碼，並套用你的選項。以預設值嵌入貼文會長這樣：

<div class="fb-post" data-href="https://www.facebook.com/facebook/posts/10153231379946729" data-width="500"></div>
<div id="fb-root"></div>
<script async defer src="https://connect.facebook.net/en_US/sdk.js#xfbml=1&version=v26.0"></script>

逐段解析：

• 外掛 div 類別 – fb-post、fb-video 或 fb-page 告訴 SDK 要初始化哪個外掛。每次嵌入僅用一個類別。
• data-href – 上一節的正規網址，已做 & 跳脫。這是三種外掛唯一必填的屬性。
• data-width（貼文與影片）– 期望的寬度，單位像素。貼文接受 350–750，本工具預設 500，影片 220–1920 預設 500。Facebook SDK 會在可行時將卡片縮放到此寬度。
• data-show-text – 勾選顯示貼文文字時出現。Facebook 對含相片的貼文與影片有文件說明，沒有它文字可能會被隱藏。
• data-lazy – 勾選延遲載入時出現。會延後到嵌入捲動靠近時才渲染。
• data-allowfullscreen / data-autoplay / data-show-captions（僅影片）– allowfullscreen 啟用全螢幕按鈕，autoplay 在桌面載入時以靜音自動播放，show-captions 在桌面有字幕時預設顯示。關閉時三者皆不出現。
• data-tabs / data-height / data-small-header / data-adapt-container-width / data-hide-cover / data-hide-cta / data-show-facepile（僅粉絲專頁外掛）– tabs 列出可見分頁如 timeline,events,messages，預設 timeline，height 預設 500，布林值直接對應外掛的外框切換。
• 載入器 – fb-root 加上來自 connect.facebook.net/{locale}/ 的 sdk.js#xfbml=1&version=v26.0。en_US 僅為範例 – 你的語言選擇會寫入語系段。取消勾選「包含 fb-root div 與 sdk.js 載入器」時會整個省略此區塊。

以非預設值設定的粉絲專頁外掛會顯示更完整的屬性集：

<div class="fb-page" data-href="https://www.facebook.com/facebook" data-tabs="timeline,events" data-width="340" data-height="500" data-small-header="false" data-adapt-container-width="true" data-hide-cover="false" data-hide-cta="false" data-show-facepile="true"></div>

嵌入選項

每個控制項對應一個屬性。括號內為預設值。

語言（預設為你的 Toollect 網站語言 – zh-hant 對應 zh_TW、zh-hans 對應 zh_CN、en 對應 en_US，de、es、fr、it、ja、nl、pt、sv 亦同）– 顯示從 en_US 到 af_ZA 的 60 個語系，名稱依 Toollect 頁面語言本地化。包含英文在內的每個明確選擇都會寫入載入器網址。SDK 會本地化嵌入周圍的文字 – 時間戳記、讚按鈕標籤 – 永遠不會改變貼文本身。

寬度（貼文 500，影片 500，粉絲專頁 340）– 以精確數字輸入，離開欄位時立即夾回有效範圍。貼文 350–750，影片 220–1920，粉絲專頁 180–500。超出範圍的值會貼齊最近邊界 – 在影片輸入 5000 會變成 1920。

高度（粉絲專頁 500）– 僅粉絲專頁外掛，70–2048。貼文與影片沒有高度屬性 – SDK 會依寬度與內容決定卡片高度。

與相片和影片一併顯示貼文文字（關閉）– 貼文會寫入 data-show-text="true"，影片則在標籤上加註「（僅限桌面）」以呼應 Facebook 說明文字切換僅影響桌面的備註。

捲動靠近前延遲載入（關閉，適用所有分頁）– 寫入 data-lazy="true"。

允許全螢幕播放（關閉，僅影片）– 寫入 data-allowfullscreen="true"。

頁面載入時自動播放（靜音、僅限桌面）（關閉，僅影片）– 寫入 data-autoplay="true"。Facebook 文件將此描述為僅限桌面的靜音自動播放。

有字幕時預設顯示字幕（僅限桌面）（關閉，僅影片）– 寫入 data-show-captions="true"，僅限桌面。

要顯示的分頁（動態時報，粉絲專頁外掛）– 三個核取方塊 timeline / events / messages 會合併為 data-tabs="timeline,events,messages"。未勾選的分頁僅從清單中省略。

使用小標頭 / 自動適應容器寬度 / 隱藏封面相片 / 隱藏自訂行動呼籲 / 顯示好友大頭貼（粉絲專頁外掛）– 各自寫入對應的 data-* 布林值。自動適應預設開啟，好友頭像預設開啟。

包含 fb-root div 與 sdk.js 載入器（開啟）– 控制是否附加載入器區塊。已在全站載入 sdk.js 的網站應取消勾選。

語言與國際化

Facebook 的嵌入貼文常見問題與 JavaScript SDK 國際化指南都說明同一條規則 – 社交外掛的顯示語言來自 sdk.js 網址的語系段。本工具讓這點一目了然。

你的語言選擇會流入兩個地方：

• 產生的程式碼 – https://connect.facebook.net/{locale}/sdk.js#xfbml=1&version=v26.0，其中 locale 如 en_US、zh_TW、fr_FR 或 ja_JP。
• 即時預覽 – 變更下拉選單會重建預覽容器，移除先前以不同語系載入的 SDK 指令碼，清除 window.FB，再全新載入新語系後呼叫 FB.XFBML.parse。

預設值會自動跟隨你的 Toollect 網站語言 – 瀏覽 toollect.com/zh-hant/tools/facebook-embed-generator/ 會預選 zh_TW，zh-hans 預選 zh_CN，ja 預選 ja_JP，歐洲語言則對應其地區形式（de→de_DE、fr→fr_FR 等），其餘退回 en_US。沒有自動選項 – Facebook 要求明確語系，因此工具永遠會寫入一個。

哪些會變、哪些不會：

支援的顯示語言

Facebook 為 SDK 文件化了約一百個語系。下拉選單提供最常用的 60 種，名稱依 Toollect 頁面語言本地化。完整的文件化清單包括：

af_ZA 南非荷蘭文 · ar_AR 阿拉伯文 · az_AZ 亞塞拜然文 · bg_BG 保加利亞文 · bn_IN 孟加拉文 · bs_BA 波士尼亞文 · ca_ES 加泰隆尼亞文 · cs_CZ 捷克文 · da_DK 丹麥文 · de_DE 德文 · el_GR 希臘文 · en_GB 英文（英國） · en_US 英文（美國） · es_ES 西班牙文（西班牙） · es_LA 西班牙文 · et_EE 愛沙尼亞文 · eu_ES 巴斯克文 · fa_IR 波斯文 · fi_FI 芬蘭文 · fr_FR 法文 · gl_ES 加利西亞文 · gu_IN 古吉拉特文 · he_IL 希伯來文 · hi_IN 印地文 · hr_HR 克羅埃西亞文 · hu_HU 匈牙利文 · hy_AM 亞美尼亞文 · id_ID 印尼文 · is_IS 冰島文 · it_IT 義大利文 · ja_JP 日文 · jv_ID 爪哇文 · ka_GE 喬治亞文 · km_KH 高棉文 · kn_IN 卡納達文 · ko_KR 韓文 · lo_LA 寮文 · lt_LT 立陶宛文 · lv_LV 拉脫維亞文 · mk_MK 馬其頓文 · ml_IN 馬拉雅拉姆文 · mr_IN 馬拉地文 · ms_MY 馬來文 · my_MM 緬甸文 · nb_NO 挪威文 · ne_NP 尼泊爾文 · nl_NL 荷蘭文 · pa_IN 旁遮普文 · pl_PL 波蘭文 · pt_BR 葡萄牙文（巴西） · pt_PT 葡萄牙文（葡萄牙） · ro_RO 羅馬尼亞文 · ru_RU 俄文 · si_LK 僧伽羅文 · sk_SK 斯洛伐克文 · sl_SI 斯洛維尼亞文 · sq_AL 阿爾巴尼亞文 · sr_RS 塞爾維亞文 · su_ID 巽他文 · sv_SE 瑞典文 · sw_KE 史瓦希利文 · ta_IN 坦米爾文 · te_IN 泰盧固文 · th_TH 泰文 · tl_PH 菲律賓文 · tr_TR 土耳其文 · uk_UA 烏克蘭文 · ur_PK 烏爾都文 · vi_VN 越南文 · zh_CN 簡體中文 · zh_HK 中文（香港） · zh_TW 繁體中文

此下拉選單以外的任何語系，依相同模式 https://connect.facebook.net/{locale}/sdk.js 也屬有效，但上述 60 種已涵蓋 Toollect 本身提供的所有語言，因此貼上程式碼後很少需要手動編輯。

使用方式

1. 貼上 Facebook 網址到輸入框 – 上表任何接受的格式皆可，包括 m.facebook.com 與解析為粉絲專頁的 fb.me 短連結。網址配置與 www. 可省略。
2. 按下產生或按 Enter。程式碼會出現在輸出框，預覽會自動開啟並顯示真實 SDK 渲染結果。網址列也會驅動分頁 – watch 連結切到影片，粉絲專頁連結切到粉絲專頁外掛。
3. 視需要選擇分頁 – 貼文、相片與社團貼文選貼文，影片與 Reels 選影片，粉絲專頁選粉絲專頁外掛。切換時會以該分頁的選項重新產生，不符的分頁會清空過時輸出。
4. 設定語言 – 預設已符合你的網站語言，但你可從 60 個語系中任選。產生的載入器網址與預覽都會立即切換。
5. 調整其餘選項 – 寬度、粉絲專頁用高度、標頭與封面切換、延遲載入。每次變更都會重新產生，程式碼區塊與預覽永不脫節。
6. 查看預覽診斷 – 若未出現卡片，輸出上方的警告會說明是 SDK 被阻擋、內容無法渲染，或網址指向個人動態牆而非粉絲專頁。
7. 複製程式碼並貼到頁面上要顯示嵌入的位置。若網站已載入 sdk.js，請取消勾選載入器包含選項以避免重複。

不符合支援格式的輸入會清空輸出，並在紅色錯誤區說明原因 – 非法連結訊息或短連結訊息。清除會一次重置輸入、程式碼與預覽。

教學

跟著一個真實連結走過三個分頁。

步驟 1 – 貼上如應用程式分享的貼文連結。 複製帶有追蹤參數的貼文網址：

https://m.facebook.com/facebook/posts/pfbid0AbCdEfGhIjKlMnOpQrStUvWxYz1234567890?__tn__=K-R

按下產生。解析器會越過 m. 子網域與 __tn__ 追蹤參數，識別為 facebook 的貼文 pfbid0AbCdEfGhIjKlMnOpQrStUvWxYz1234567890，分頁維持在貼文，程式碼顯示 data-width="500" 與 en_US 載入器，因為此演練位於英文站。預覽開啟，卡片以 500 像素渲染。

步驟 2 – 變更語言。 將貼文語言切到繁體中文 zh_TW。載入器變為 https://connect.facebook.net/zh_TW/sdk.js#xfbml=1&version=v26.0，預覽重新載入 SDK – 貼文旁的時間戳記切換為中文形式，而貼文內文完全保持原樣。

步驟 3 – 調窄。 在寬度輸入 600 並離開欄位。div 增加 data-width="600"，卡片隨之改變。試著輸入 9999 再離開 – 欄位會貼齊到貼文上限 750。

步驟 4 – 切到影片。 在輸入框將貼文網址替換為影片：

https://www.facebook.com/facebook/videos/10153231379946729/

按下產生。工具切到影片，程式碼變為 <div class="fb-video" data-href="https://www.facebook.com/facebook/videos/10153231379946729" data-width="500">，語言下拉仍顯示相同的 en_US 預設值。勾選自動播放與顯示字幕 – 各自寫入其 data-*，標籤上保留僅限桌面的說明。

步驟 5 – 粉絲專頁外掛。 貼上 https://www.facebook.com/facebook 並產生。粉絲專頁外掛分頁以 data-tabs="timeline" 與完整外框設定開啟。勾選活動與訊息 – 屬性變為 data-tabs="timeline,events,messages"。將寬度改為 500、高度改為 700 – 兩個屬性皆更新。預覽如實顯示粉絲專頁的動態牆、封面與好友頭像，與貼到網站上的效果一致。

步驟 6 – 複製並上線。 按下複製，貼到已載入 sdk.js 的純 HTML 頁面 – 複製前先取消勾選載入器。開啟頁面 – 貼文、影片與粉絲專頁各自以你設定的寬度與語言渲染。

預覽與診斷

預覽會對你來自 buildSdkCode 的精確 div 執行 Facebook 真正的 sdk.js，因此它會在與你的頁面相同的位置失敗。容器在下載 sdk.js 與執行 FB.XFBML.parse 期間顯示轉圈，之後呈現四種結果之一：

兩種計時警告皆在寬鬆等待後才觸發 – SDK 下載 20 秒、渲染再 15 秒 – 因此連線較慢不會造成誤報。可嵌入的貼文遠在時限內即可渲染，個人檔案的粉絲專頁外掛則在 iframe 維持零尺寸約三秒後顯示黃色警告。

一個值得了解的細節：產生器會追蹤 loadedLocale。成功渲染後變更語言時，會移除先前的 sdk.js script 標籤、清除 window.FB，再全新載入新語系後解析。先前語系已渲染的卡片會在新解析前從預覽容器中清除，因此預覽永遠與你將複製的載入器網址一致。

專業提示

• 與 Facebook 連結解析器搭配使用。 解析器分析並清理連結 – 類型、使用者名稱、ID、已移除的追蹤鍵 – 而此產生器將乾淨連結轉為程式碼。以解析器歸檔，以產生器發布。
• 一個載入器、多個嵌入。 含多個 Facebook 嵌入的頁面只需載入一次 sdk.js – 第一個嵌入勾選載入器產生，其餘不勾選，或在網站樣板中自行載入 SDK 並全部省略。fb-root div 每頁也只需一次。
• 先為版心設計，再設定寬度。 Facebook 卡片在選項表的寬度附近視覺上達到上限，預覽會在定案前顯示容器尺寸下的真實結果。輸入精確像素值 – 567 也有效 – 僅在超出文件範圍時才會被夾回。
• 以影片為主的貼文請用影片模式。 透過貼文外掛嵌入的影片會渲染為靜態卡片 – 以 fb-video 嵌入則渲染為帶自動播放與字幕控制的播放器，符合外掛文件。
• 明確鎖定語言。 讓外框跟隨宿主頁的 <html lang> 會使輸出取決於貼上位置。包含 en_US 在內的每個明確選擇都會將語系寫入程式碼，無論宿主為何都能重現相同標籤。
• 厚重頁面使用延遲載入。 含三個粉絲專頁外掛動態牆的文章可直接受益於 data-lazy – SDK 會延後解析直到嵌入捲動靠近。
• 粉絲專頁外掛分頁保持最少。 每增加一個分頁都會增加高度與網路成本 – 僅 timeline 是最快的初始渲染，僅在頁面真的需要時才加入 events 與 messages。

替代方案

還有哪些方式可將 Facebook 內容放到頁面上？

Facebook 官方設定工具是最接近的替代方案，也是相同 data-* 語彙的來源 – 但它將貼文、影片與粉絲專頁分散到不同頁面，不提供個人與粉絲專頁區分的警告，也不會產生含完整工具語言清單的貼文/影片/粉絲專頁整合輸出。Graph API 路線以應用程式、權杖與持續審核為代價換取完全控制，渲染仍由你負責。第三方服務則插入其自家指令碼。產生器位居實用的中間 – 官方標記、完整選項、即時視覺確認。

與官方 API 比較

觸及 Facebook 嵌入的官方介面有兩個，產生器直接建構在更友善、無需金鑰的那一個之上。

產生器不會呼叫任何 Graph 端點。它依規則建構社交外掛標記，重現設定工具會輸出的內容，並仰賴 SDK 自身的 FB.XFBML.parse 進行渲染。Graph API 未參與 – 透過它取得貼文資料需要權杖，且渲染仍由你完成，而 SDK 已免費渲染官方卡片。

產生器 vs. URL 解析器

Toollect 提供兩個接受相同連結的 Facebook 工具，分工值得一看：

解析器是分析師，產生器是建構者。發布流程中兩者依序使用才完整 – 先以解析器識別並正規化雜亂分享連結指向的目標，再以產生器放到頁面上。兩者依相同語法建構，因此解析器接受為可嵌入貼文或影片的連結，本產生器即可嵌入，而本產生器拒絕的連結也能由解析器的類型與訊息說明。

功能限制

為避免過度信任，先說明邊界：

• 不會直接嵌入 fb.watch 短連結。 短連結在 Facebook 重新導向前不含目的地。請貼上展開後的貼文或影片網址。
• 無法僅憑網址可靠區分粉絲專頁與個人檔案。 兩者皆共用 facebook.com/{username} 與 profile.php?id=...。靜態允許清單會擋掉真實粉絲專頁或放行個人檔案 – 現實中兩者皆曾發生 – 因此工具對任何粉絲專頁形狀的網址都會產生程式碼，僅在 SDK 渲染出零或極小 iframe 或回報渲染錯誤時，才顯示黃色預覽警告。
• 不會覆寫隱私或限制。 私密貼文、觀看者無權限的社團貼文、受年齡或地區限制的粉絲專頁，以及作者已關閉嵌入的內容，即使程式碼正確也會渲染為空白或受限檢視，即使是 Facebook 官方設定工具也會如此。
• 不會在渲染前先取得或驗證貼文內容。 驗證是語法層級 – 內容是否存在且可嵌入，僅在 SDK 解析 div 時才有答案。
• 不會設定卡片樣式。 渲染後外掛內部的顏色、字型與外框皆由 Facebook 決定。你能控制的僅是存在與尺寸 – 是否顯示文字、封面、好友頭像、延遲與數字寬高。
• 不會自動安裝程式碼。 你複製的就是你貼上的，工具無法伸入你的 CMS 或頁面建構器。

疑難排解

隱私與資料處理

本工具對其流量誠實以告。

• 產生本身在本地完成。 解析網址、對應到分頁、組裝 fb-* div 皆以 JavaScript 字串操作在你的瀏覽器中完成。沒有 Toollect 伺服器會看到你貼上的連結。
• 預覽會載入 Facebook 機制。 渲染卡片會從 connect.facebook.net 依所選語系取得 sdk.js，呼叫 FB.init 與 FB.XFBML.parse，渲染後的 iframe 則來自 facebook.com 與 fbcdn.net – 正是你複製的程式碼在讀者瀏覽器中會產生的流量。
• 語言選擇會寫入程式碼。 選擇 ja_JP 即會將該語系寫入你貼上的載入器網址，訪客瀏覽器將取得該語系的 SDK。Toollect 不會儲存任何偏好。
• 無帳號、無儲存、無分析。 工具在記憶體內預覽容器之外不保留任何狀態，關閉分頁即結束一切。
• 發布程式碼代表訪客會與 Facebook 通訊。 這是嵌入第三方社交內容的本質 – 值得直言。若你需要完全離線的 Facebook 流程，本站的 Facebook 連結解析器可在零網路請求下完成全部工作。

技術規格

詳細資訊：

• 輸出：SDK div fb-post / fb-video / fb-page 含文件化 data-* 屬性，加上 fb-root 與來自 https://connect.facebook.net/{locale}/sdk.js 的 sdk.js#xfbml=1&version=v26.0；關閉「包含 fb-root div 與 sdk.js 載入器」時省略載入器區塊
• 輸入語法：主機 facebook.com 含任意子網域、fb.watch、fb.me；使用者名稱 2–50 字元 [A-Za-z0-9.]；分頁 [a-z][a-z0-9_]* 且拒絕數字第二段；ID 為 5–20 位數字或 pfbid[1,200]；短碼 5–40 字元英數；保留清單 43 項；profile.php?id= 與 /username 皆路由至粉絲專頁，留待渲染時驗證
• 正規輸出網址：粉絲專頁為 https://www.facebook.com/{username} 或 profile.php?id=，貼文為 .../posts/{id} / share/p/{id}/ / story.php?story_fbid=...，影片為 .../videos/{id} 或 watch/?v=，Reels 為 .../reels/{id} / reel/{id}，相片為 .../photo/?fbid=，社團貼文為 .../groups/{gid}/posts/{id}
• 尺寸：貼文 350–750 預設 500，影片 220–1920 預設 500，粉絲專頁 寬度 180–500 預設 340 加 高度 70–2048 預設 500；data-width / data-height 直接寫入，不涉及 iframe 尺寸
• 語言：可選 60 個 fbeLangCodes 任一；fbeLangDefault 跟隨 Toollect 頁面語言 – zh-hant→zh_TW、zh-hans→zh_CN、en→en_US、de→de_DE、es→es_ES、fr→fr_FR、it→it_IT、ja→ja_JP、nl→nl_NL、pt→pt_BR、sv→sv_SE；語系寫入載入器網址並由預覽 SDK 透過 loadedLocale 追蹤重新載入
• 預覽生命週期：renderPreview 注入 fb-root 加 fb-* div，loadSdkJs(locale, cb) 管理含語系敏感重新載入的快取 sdk.js（切換時移除舊指令碼與 window.FB），在容器上呼叫 FB.XFBML.parse，startWatcher 每 500 毫秒輪詢 iframe 最多 30 次（15 秒）並在持續 0×0 時最多 6 次（約 3 秒）後顯示個人檔案警告，setPreviewLoading 在四個退出點統一，fbe-fallback 連結在任何診斷時指向 lastCanonical
• 瀏覽器支援：所有支援 clipboard API 與 async / defer 指令碼的現代瀏覽器；SDK 渲染需要第三方指令碼執行與 connect.facebook.net 可連線

功能特色

• 一鍵產生貼文、影片與粉絲專頁外掛的官方 Facebook JavaScript SDK 嵌入程式碼
• 複製前先以 Facebook 官方 sdk.js 渲染即時預覽 – 含 SDK 載入失敗與逾時診斷
• 從 60 種顯示語言中選擇 – 你的選擇會寫入訪客載入的 sdk.js 載入器網址
• 精細調整每個官方外掛選項 – 寬度、粉絲專頁分頁、封面、標頭、好友頭像與延遲載入
• 僅輸出 SDK 程式碼，適用任何網站 – 視需要包含或省略 fb-root 與載入器
• 免費且在瀏覽器內完成 – 無需 API 金鑰、無需帳號、無需經過 Toollect 伺服器

常見問題