i18N - クライアント

  • リリースバージョン: Yokohama
  • 更新日 2025年01月30日
  • 所要時間：1分

    • i18N API は、翻訳されたメッセージを取得して書式設定するためのメソッドを提供します。

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

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

    特定のトークンを含む文字列を、マップの値でフォーマットします。

    表 : 1. パラメーター
    名前 タイプ 説明
    message 文字列 トークンを追加するメッセージ。
    map オブジェクト メッセージ内で置換する名前と値のペアのマップ。
    表 : 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 アレイ 取得するメッセージを指定するキーのアレイ。
    callback 関数 メッセージが取得されたときに呼び出される関数。コールバック関数には引数が 1 つ含まれます。これはキーと値のペアを含むオブジェクトで、キーは要求されたメッセージキー、値は翻訳された文字列です。
    表 : 6. 返される内容
    タイプ 説明
    なし