v0.6.22

i18n

最後更新


本頁說明如何定義語系、在文字與屬性中引用翻譯,以及切換語言。

定義語系


  1. <div id="app">
  2. <h1>{{ i18n.title }}</h1>
  3. <input placeholder="i18n.search" />
  4. <button @click="toEn">English</button>
  5. </div>
  6. <script>
  7. const app = new QUI({
  8. id: "app",
  9. i18n: {
  10. zh: { title: "歡迎", search: "搜尋" },
  11. en: "/i18n/en.json",
  12. },
  13. i18nLang: "zh",
  14. event: {
  15. toEn: () => app.lang("en"),
  16. },
  17. });
  18. </script>
即時預覽 · @pardnchiu/quickui@0.6.22

選項說明
i18n語系代碼對應到物件,或對應到 JSON 檔的 URL
i18nLang初始語系,預設 "zh"

字串值會在初始渲染前以 fetch 載入;載入失敗或回應非 2xx 時該語系視為空物件,不會中斷渲染。

引用翻譯


位置寫法key 規則找不到時
文字{{ i18n.menu.home }}支援以 . 存取巢狀 key顯示 key 本身(menu.home)
屬性值placeholder="i18n.search"只支援單層 key保留原字串 i18n.search

屬性值必須整個是 i18n.key,不能混入其他文字。

切換語言


app.lang(code) 會更新目前語系並觸發重新渲染;code 不在 i18n 中時不做任何事。once: true 的實例資料不具響應性,切換後不會重新渲染。

保留鍵


語系資料存放在 app.data.quickui_i18n,目前語系存放在 app.data.quickui_i18nLang。不要在自己的 data 中使用這兩個名稱。
EN