Widget API (WOVN.io Javascript)

WOVN.io.changeLang(langCode)

ページを表示する言語を変更します。

• 引数に 'en' や 'ja' などの言語コードを設定してください。
• 有効な言語コードが設定された場合、true を返します。それ以外の場合には false を返します。

例：

```js

> WOVN.io.changeLang('en')

< true

```

WOVN.io.getCurrentLang()

ページ上で現在表示されている言語を取得します。

• 引数はありません。
• オブジェクトを返します。（下記例を参照）

例：

```js

​ ​> WOVN.io.getCurrentLang()

< Object {name: "English", code: "en", en: "English"}

```

WOVN.io.getTextTranslation(text, toLang)

翻訳されたテキストを返します。

• 引数 text に元言語のテキストを、toLang に翻訳言語の言語コードを設定してください。
• 翻訳されたテキストが返されます。
• このメソッドは、呼び出したページに紐付く WOVN 上に格納されている翻訳データを用います。したがって、過去に一度も翻訳をしたことのないデータは置換されず、元言語のままになります。

例：

```js

> WOVN.io.getTextTranslation('Hello world', 'ja');

< 'こんにちは世界'

```

WOVN.io.getWovnUrl(url)

選択中の言語とプロジェクト設定に基づいて、URL に対応した 言語コード付き URL を取得します。 

• 引数に URL を設定してください。(‘https://wovn.io’, ‘/top’, etc.)
  引数は完全修飾 URL か絶対パスである必要があります。

• 翻訳されたページの URL を返します。(‘https://wovn.io’ -> ‘https://wovn.io/ja’, ‘/top’ -> ‘/ja/top’, etc)

例：

```js

> WOVN.io.getWovnUrl('/shop')

< '/ja/shop'

```

WOVN.io.isApiReady()

WOVN スクリプトの読み込みが完了しているか、boolean で返します。

例：

```js

> WOVN.io.isApiReady();

< true

```

例2：

```js

if (window.WOVN && WOVN.io && WOVN.io.isApiReady()) {

    // something

} else {

    window.addEventListener('wovnApiReady',function(){

        // something

    })

}

```

WOVN.io.isPublished(langCode)

言語の公開ステータスを取得します。

• 引数に 'en' や 'ja' などの言語コードを設定してください。
• 引数に設定した言語のページが公開されている場合、true を返します。それ以外の場合には false を返します。

例：

```js

> WOVN.io.isPublished('en');

< true

```

WOVN.io.manualStart()

WOVN のブラウザ側処理を、任意のタイミングで開始することができます。

独自言語切替ウィジェット を設置する場合、独自言語切替ウィジェットタグがブラウザ上にマウントされた後に WOVN が実行される必要があります。ただし、対象 Web ページに紐づくサービスの構成によってはこの処理順序を保証できないことがあります。
Web ページの一連の処理完了後に WOVN.io.manualStart() メソッドを実行すると、独自言語切替ウィジェットの処理を正常に実行できるようになります。

```js

> WOVN.io.manualStart();

<

```

注意
この機能を利用する場合は、翻訳対象の全ページで manualStart() を実行してください。自動で WOVN が実行されず、実行待ちの状態になるためです。

インフォメーション
この機能はオプション機能となっているため、利用の際にはお問い合わせください。

WOVN.io.optOut()

WOVN が利用する Cookie を無効にします。このメソッドを実行すると、ユーザーが行った言語切替え状態が保持されなくなります。また、言語切替え状態を保持しないので、毎回ブラウザ言語判定による言語切替えを実行します。

利用するときは、wovnApiReady イベントハンドラーと組み合わせて実行します。

• 引数はありません。
• 戻り値はありません。

```js

window.addEventListener('wovnApiReady', function(evt) {

    WOVN.io.optOut();

});

```

注意
例外的に wovn-optedOutCookies がセットされます。これはオプトアウト設定を保持するために設定する Cookieです。

WOVN.io.optInCookies()

メソッド実行後から WOVN.io が定義した各種 Cookie の使用を開始します。この機能を利用するには、カスタマーサポートまでお問い合わせください。

例：

```js

> WOVN.io.optInCookies();

< undefined

```

WOVN.io.translateTexts(fromLang, toLang, texts)

テキストの配列を受け取り、翻訳されたテキストを返します。

• 引数 fromLang と toLang に言語コードを、texts に元言語のテキスト配列を設定してください。
• 元言語テキストと翻訳言語テキストのキーバリューを持つ連想配列が返されます。
• このメソッドは、呼び出したページに紐付く WOVN 上に格納されている翻訳データを用います。したがって、過去に一度も翻訳をしたことのないデータは置換されず、元言語のままになります。

例：

```js

> WOVN.io.translateTexts('en', 'ja', ['good afternoon', 'good night'])

> {'good afternoon': 'こんにちは', 'good night': 'おやすみ'}

```

wovnApiReady

WOVN スクリプトの読み込みが完了した後に呼び出されます。JavaScript でページの言語を変更したい場合、このイベントハンドラーを使用して下記のように変更することができます。
例：

```js

window.addEventListener('wovnApiReady', function(evt) {

    WOVN.io.changeLang('en');

});

```

wovnLangChanged

ウィジェットがページ上の言語を変更するたびに呼び出されます。

言語がユーザーの設定やブラウザの言語に基づいて自動的に変更された場合、このイベントが呼び出されます。

このイベントハンドラーと WOVN.io.getCurrentLang() メソッドで取得できる翻訳言語を併用することで、言語ごとに別の動作をさせることができます。

例：

```js

window.addEventListener('wovnLangChanged', function (evt) {

    var newLang = WOVN.io.getCurrentLang().code;

    document.getElementById('support-content').setAttribute('href', 'http://cdn.com/' + newLang + '/info.pdf');

});

```