i18N - Cliente

  • Versão de lançamento: Yokohama
  • Atualizado 30 de jan. de 2025
  • 1 min. de leitura
  • A API i18N fornece métodos para obter e formatar mensagens traduzidas.

    Os métodos i18N são acessados usando o objeto global g_i18n.

    i18N - format (cadeia de caracteres de mensagem, mapa de objetos)

    Formata uma cadeia de caracteres que contém tokens nomeados com valores de um mapa.

    Tabela 1. Parâmetros
    Nome Tipo Descrição
    message Cadeia de caracteres A mensagem para que os tokens sejam adicionados.
    mapa Objeto O mapa de pares de nome/valor a serem substituídos na mensagem.
    Tabela 2. Retornos
    Tipo Descrição
    Cadeia de caracteres A cadeia de caracteres formatada
    // 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 (cadeia de caracteres msgKey, retorno de chamada de função)

    Recupera uma mensagem traduzida.

    Se a cadeia de caracteres especificada existir no banco de dados para o idioma atual, a mensagem traduzida será retornada. Se a cadeia de caracteres especificada não existir para o idioma atual, a versão em inglês da cadeia de caracteres será retornada. Se a cadeia de caracteres não existir no banco de dados, o próprio ID será retornado.

    Tabela 3. Parâmetros
    Nome Tipo Descrição
    msgKey Cadeia de caracteres A mensagem a ser recuperada.
    retorno de chamada Função A função a ser chamada quando a mensagem for recuperada. A função de retorno de chamada tem um argumento, uma cadeia de caracteres que é a mensagem traduzida.
    Tabela 4. Retornos
    Tipo Descrição
    vazio

    i18N - getMessages (msgKeys de matriz, retorno de chamada de função)

    Recupera um conjunto de mensagens.

    Se a cadeia de caracteres especificada existir no banco de dados para o idioma atual, a mensagem traduzida será retornada. Se a cadeia de caracteres especificada não existir para o idioma atual, a versão em inglês da cadeia de caracteres será retornada. Se a cadeia de caracteres não existir no banco de dados, o próprio ID será retornado.

    Tabela 5. Parâmetros
    Nome Tipo Descrição
    msgKeys Matriz Uma matriz de chaves que especifica as mensagens a serem recuperadas.
    retorno de chamada Função A função a ser chamada quando as mensagens forem recuperadas. A função de retorno de chamada tem um argumento, um objeto que contém pares de chave-valor, em que chave é a chave da mensagem solicitada e o valor é a cadeia de caracteres traduzida.
    Tabela 6. Retornos
    Tipo Descrição
    vazio