i18N: クライアント

  • リリースバージョン: Australia
  • 更新日 2026年03月12日
  • 所要時間：2分

    • i18N API は、翻訳されたメッセージを取得してフォーマットするためのメソッドを提供します。

    i18N メソッドには、g_i18n グローバルオブジェクトを使用してアクセスします。

    i18N - format(文字列メッセージ, オブジェクトマップ)

    名前付きトークンを含む文字列をマップの値でフォーマットします。

    表 : 1. パラメーター
    名前 タイプ 説明
    message 文字列 トークンを追加するメッセージ。
    マップ オブジェクト メッセージ内で置き換える名前/値ペアのマップ。
    表 : 2. 返される内容
    タイプ 説明
    文字列 書式設定された文字列 
    // Returns: "The rich young ruler was very very rich"
nowapi.g_i18n.format("The {p1} {p2} {p3} was very very {p1}",{p1: "rich", p2: "young", p3: "ruler"});

    i18N - getMessage(文字列 msgKey, 関数コールバック)

    翻訳されたメッセージを取得します。

    指定された文字列が現在の言語のデータベースに存在する場合は、翻訳されたメッセージが返されます。指定された文字列が現在の言語に存在しない場合は、英語バージョンの文字列が返されます。文字列がデータベースにまったく存在しない場合は、ID 自体が返されます。

    表 : 3. パラメーター
    名前 タイプ 説明
    msgKey 文字列 取得するメッセージ。
    コールバック 関数 メッセージが取得されたときに呼び出される関数。コールバック関数には 1 つの引数 (翻訳されたメッセージである文字列) があります。
    表 : 4. 返される内容
    タイプ 説明
    なし

    i18N - getMessages(アレイ msgKeys, 関数コールバック)

    一連のメッセージを取得します。

    指定された文字列が現在の言語のデータベースに存在する場合は、翻訳されたメッセージが返されます。指定された文字列が現在の言語に存在しない場合は、英語バージョンの文字列が返されます。文字列がデータベースにまったく存在しない場合は、ID 自体が返されます。

    表 : 5. パラメーター
    名前 タイプ 説明
    msgKey アレイ 取得するメッセージを指定するキーのアレイ。
    コールバック 関数 メッセージが取得されたときに呼び出される関数。コールバック関数には 1 つの引数、つまりキーと値のペアを含むオブジェクトがあります。ここで、key は要求されたメッセージキー、値は翻訳された文字列です。
    表 : 6. 返される内容
    タイプ 説明
    なし