I18n - Cliente

  • Versão de lançamento: Zurich
  • Atualizado 31 de jul. de 2025
  • 1 min. de leitura
  • . I18n A API fornece métodos para obter e formatar mensagens traduzidas.

    . I18n os métodos são acessados usando g_i18n objeto global.

    I18N - format(mensagem de cadeia de caracteres, mapa de objeto)

    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 adicionar os tokens.
    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 da 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(Array msgKeys, retorno de chamada da 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