Accessibird 會以所在頁面的語言顯示小工具選單,您不需要進行任何設定。
如何決定使用的語言
小工具會依照以下順序,採用第一個符合條件的語言設定:
- 訪客在小工具中選擇的語言(會在該裝置上,針對每個網站分別記住設定)。
- 嵌入程式碼中的
data-lang,或載入程式網址中的?lang=。如果兩者都有設定,會優先使用data-lang。 - 頁面本身的語言(
<html lang>)。 - 頁面的
content-language或og:locale中繼標籤。 - 訪客瀏覽器的語言設定。
- 英文。
只有在頁面和瀏覽器都未提供語言設定時,才會使用您在管理介面中設定的預設語言。
指定固定語言
<script src="https://widget.accessibird.com/loader.js" data-website-id="YOUR_WEBSITE_ID" data-lang="nl" async></script>也可以在網址中指定語言:
<script src="https://widget.accessibird.com/loader.js?lang=zh-tw" data-website-id="YOUR_WEBSITE_ID" async></script>設定 data-lang="auto" 的效果與省略此設定相同。
實用提醒
- 即時切換:如果您的網站不必重新載入頁面就能切換語言,例如透過語言切換按鈕,小工具也會跟著切換,除非訪客已自行選擇語言。
- 由右至左:使用阿拉伯文、希伯來文等語言時,小工具會以由右至左的方向顯示。
- 小提示:請確認頁面已設定正確的語言,例如
<html lang="nl">。大多數網站架設工具都會幫您完成這項設定。 - 再次造訪的訪客:此次更新後,訪客先前選擇的語言會被清除一次。他們可以在小工具中重新選擇。
開發人員資訊
Accessibird.setLanguage('nl'); // set the language
Accessibird.getLanguage(); // read the current language
Accessibird.resetLanguage(); // go back to automatic
window.addEventListener('accessibird:languagechange', e => console.log(e.detail)); // { lang, source }
// Before the widget has loaded:
window.Accessibird = window.Accessibird || { q: [] };
Accessibird.q.push(['setLanguage', 'nl']);