如果安裝後小工具沒有顯示,幾乎都是以下三種原因之一:正式網站的頁面上沒有程式碼片段、頁面仍使用快取,或內容安全政策封鎖了指令碼。
確認正式網站已加入程式碼片段
開啟已發布的網站,檢視網頁原始碼,並搜尋 accessibird。如果找不到,表示變更尚未儲存或尚未部署。請從 CMS 重新發布,或再次推送程式碼變更。
略過快取
瀏覽器和 CDN 會大量快取 HTML 和指令碼。請按 Ctrl+Shift+R(Mac 上則按 Cmd+Shift+R)強制重新整理。如果使用 Cloudflare 等 CDN,也請清除該頁面的快取。
檢查內容安全政策
如果網站傳送的 Content-Security-Policy 標頭設有嚴格規則,您可能需要在 script-src 和 connect-src 中允許 accessibird.com。開啟瀏覽器主控台,即可清楚看到指令碼遭封鎖的訊息;調整政策以允許載入即可解決。
使用測試頁面確認
管理後台中的小工具測試頁面會在乾淨的環境中載入小工具。如果小工具在測試頁面能正常運作,在您的網站上卻不行,問題就出在網站,而不是 Accessibird。
從您自己的網站載入
小工具的請求必須直接來自您自己的網站。Localhost 和預覽網址不會計入「使用中」或「已驗證」狀態,因此請在正式網站上檢查。
