事件

VoerkaI18n和i18nScope提供了一些事件来侦听语言切换、语言包加载等事件。

• VoerkaI18n实例继承自一个LiteEventEmitter类，可以通过on/off/once方法来侦听事件。
• i18nScope引用了全局VoerkaI18n实例的on/off/once方法

ready

当i18nScope实例完成第一次语言切换时会触发ready事件，相当于第一次触发change事件。

• 此方法一般用在Vue/React等应用中，用来等待语言包加载完成再进行初始化。
• ready事件只会触发一次，之后再次切换语言不会再触发。
• ready事件具备retain特性，即如果在ready事件触发后再订阅了ready事件，也可以侦听到ready事件。
• 引入ready事件是因为语言包可能是异步加载的，如果在语言包加载完成前就开始使用t函数，可能会导致翻译不准确。因此，可以在ready事件中初始化应用。
• ready事件回调函数：({language,scope})=>void，其中language是当前语言，scope是当前作用域id。

import { i18nScope } from "./languages"

i18nScope.on("ready",({language,scope})=>{
    // 初始语言包加载完成，可以在此初始化`Vue/React`等应用中
    // 在Vue3中可以在此初始化Vue应用
    const app = createApp(App)
    // 应用插件
    app.use<VoerkaI18nPluginOptions>(i18nPlugin as any,{
        i18nScope
    })
    app.mount('#app')
})

change

当切换语言时会触发change事件。

当每次调用i18nScope.change或VoerkaI18n.change方法时，VoekaI18n会进行语言包加载和切换，加载远程语言补丁，存储语言参数等一系列操作，然后完成后再触发change事件。

import { i18nScope } from "./languages"

i18nScope.on("change",(newLanguage)=>{
    // 语言切换完成，可以在此重新渲染界面
    // ...
})

registered

当scope注册到全局VoerkaI18n实例时会触发registered事件。

i18nScope.on("registered",({language,scope})=>{
    // 语言切换完成，可以在此重新渲染界面
    // ...
})

• registered事件回调函数：({language,scope})=>void，其中language是当前语言，scope是当前作用域id。
• 一个应用可能会有多个scope，每个scope都会触发registered事件。

restore

每次切换语言（包括初始化时），VoerkaI18n均会从存储中恢复语言补丁，然后触发restore事件。

i18nScope.on("restore",({language,scope})=>{
    // 从存储中恢复语言补丁完成
    // ...
})

patched

每次切换语言（包括初始化时），VoerkaI18n均会远程服务器加载语言补丁，然后触发patched事件。

i18nScope.on("patched",({language,scope})=>{
    // 从存储中恢复语言补丁完成
    // ...
})