i18N - Cliente

  • Versão de lançamento: Washingtondc
  • Atualizado 1 de fev. de 2024
  • 1 min. de leitura
  • 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 mensagem, 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. Retorna
    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, função de retorno de chamada)

    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. Retorna
    Tipo Descrição
    vazio

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

    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. Retorna
    Tipo Descrição
    vazio