Documentação

Prontidão global e cultura

Descubra o que seu código existente ainda assume sobre um idioma ou uma cultura específica, corrija isso em pequenas tarefas e veja o que cada mercado espera de datas, números, dinheiro, endereços e nomes.

Um projeto internacionalizado tem duas seções sob Internacionalização em sua bancada. Prontidão global trata do código que você já possui. Cultura diz respeito aos mercados onde você vende. O Verificação de Globalização impede que novo código aumente o que a Prontidão global identifica.

Prontidão global

A Prontidão global lista o que o código no seu branch padrão ainda assume sobre um idioma ou uma cultura específica. O Coroid analisa o código com as mesmas regras que a Verificação de Globalização aplica a uma alteração, sem executá-lo, e relata cada resultado. Nada aqui bloqueia nada: é código existente, e você o corrige no seu próprio ritmo.

Internacionalização
Loja virtual
inglês origem · 5 idiomas · verificado há 2 horas em 3f2c9a1
  • Prontidão mundial
  • Cultura
  • Visão geral
  • Strings
  • Sugestões
  • Trocar
  • Colaboradores
  • Automações
  • Configurações
Prontidão global

O que o código no branch padrão ainda presume sobre um único idioma ou cultura. Corrija isso em tarefas pequenas; a verificação de Globalização impede que o novo código introduza mais suposições desse tipo.

Verificar novamente

Concluído: 3f2c9a1 há 2 horas

Achados214Em 1.284 leitura de arquivos
Desde a última verificação-18Comparado com a verificação há 3 dias
O que foi encontrado
  • Texto escrito diretamente no códigoBloqueado em novo código por padrãoTexto que as pessoas leem, escrito diretamente no código em vez do catálogo.142-9Criar uma tarefa de correção
  • Frase montada a partir de partesBloqueado em novo código por padrãoUma frase unida a partir de partes. A ordem das palavras difere entre os idiomas.23-3
  • Número formatado sem a localidadeUm número formatado sem a localidade do leitor.31-4
  • Lista unida manualmenteUma lista que as pessoas leem é unida com vírgula ou "e", o que outros idiomas escrevem de forma diferente.12-2
  • Entrada processada enquanto uma palavra está sendo compostaPressionar Enter para escolher uma palavra chinesa, japonesa ou coreana envia o formulário antes que a palavra seja escolhida.6
Arquivos · Texto escrito diretamente no código37 arquivos
  1. src/components/checkout/summary.tsxTexto escrito diretamente no código: 18 · Número formatado sem a localidade: 418
    1. 42:9Resumo do pedido
    2. 57:13Frete grátis em todo pedido
    3. 61:11Aplicar código
  2. src/app/account/page.tsxTexto escrito diretamente no código: 11 · Frase montada a partir de partes: 211
  3. src/components/cart/empty-state.tsxTexto escrito diretamente no código: 77

Prontidão mundial na estação de trabalho: o que o código no branch padrão ainda presume sobre um idioma ou cultura, por código de problema, com os arquivos para corrigir e uma tarefa de correção. Dados ilustrativos.

A seção exibe:

  • Achados, com a quantidade de arquivos lidos e a alteração desde a última verificação.
  • O que foi encontrado: uma linha por tipo de resultado, com sua contagem. Textos escritos no código e frases montadas a partir de partes são marcados Bloqueado em novo código por padrão, porque a Verificação de Globalização retorna uma alteração que os adiciona.
  • Arquivos: os arquivos com mais resultados primeiro. Selecione um tipo para ver apenas seus arquivos e um arquivo para visualizar cada resultado com sua linha e o texto encontrado.

Quando você abre a Prontidão global e o código no branch padrão mudou desde a última verificação, o Coroid o analisa novamente. Verificar novamente o analisa agora. Um projeto com mais de 20.000 resultados lista os primeiros 20.000; as contagens incluem todos os resultados.

Os tipos de resultado e como corrigir cada um estão em Projeto para cada mercado. O código que você omite intencionalmente recebe um i18n-ignore comentário com seu motivo, e pastas inteiras podem ser omitidas no arquivo de configuração (veja O que a verificação analisa).

Tarefas de correção

Proprietários e administradores selecionam Criar uma tarefa de correção para um tipo de resultado. O Coroid gera uma tarefa para esse tipo, com os arquivos e linhas a serem corrigidos e como fazê-lo. Uma tarefa abrange no máximo 15 arquivos ou 150 resultados, começando pelos piores arquivos, para permanecer revisável; quando ela for mesclada, a próxima verificação mostrará o que resta.

A tarefa está aguardando que você a inicie. Solicitar novamente enquanto ela estiver aberta abre a mesma tarefa. A linha indica se a tarefa de correção está em andamento, concluída ou interrompida.

Cultura

A cultura revela o que cada mercado do projeto espera em relação a datas, números, dinheiro, endereços, números de telefone e nomes. Esses dados vêm de fontes publicadas: o Unicode CLDR para formatos, calendários, unidades e papel; os dados de endereço do Google para endereços e códigos postais; e o libphonenumber para números de telefone. O código que formata com base na localidade do leitor já faz a maior parte desse trabalho corretamente.

Internacionalização
Loja virtual
inglês origem · 5 idiomas · verificado há 2 horas em 3f2c9a1
  • Prontidão mundial
  • Cultura
  • Visão geral
  • Strings
  • Sugestões
  • Trocar
  • Colaboradores
  • Automações
  • Configurações
Cultura

O que cada mercado espera em relação a datas, números, moedas, endereços, números de telefone e nomes, conforme definido pelo Unicode CLDR e pelos dados de endereçamento publicados pelos serviços postais. O código que formata com base na localidade do leitor garante esses resultados automaticamente.

Alteração no assistente
Formatador
Formatador do next-intluseFormatter from next-intl
Dinheiro por mercado
alemão: EUR · japonês: JPY · árabe: SAR · sueco: SEK
MercadosOs valores que diferem do mercado de origem estão em tinta preta.
MercadoNúmerosDinheiroDataHorárioSemana começaPapel
inglêsen-US · Fonte12,345.678$1,299.503/14/264:05 PMdom.Letter
alemãode-DE12.345,6781.299,50 €14.03.2616:05seg.A4
japonêsja-JP12,345.678¥1,3002026/03/1416:05dom.A4
árabear-SA١٢٬٣٤٥٫٦٧٨‏١٬٢٩٩٫٥٠ ر.س.‏١٤‏/٣‏/٢٠٢٦٤:٠٥ مdom.A4
suecosv-SE12 345,6781 299,50 kr2026-03-1416:05seg.A4

Fontes: Unicode CLDR 48, dados de endereço do Google (libaddressinput) e libphonenumber. As amostras usam o mesmo momento e valores em todos os mercados.

Cultura na estação de trabalho: cada mercado escreve o mesmo número, preço, data e hora à sua maneira, inicia sua semana e imprime em seu próprio papel. Os valores vêm do navegador do leitor e do Unicode CLDR.

No topo:

  • Formatador. Como o código formata números, datas e dinheiro para o leitor, por exemplo, o formatador do next-intl, do react-intl, da i18next, os pipes do Angular ou simplesmente Intl. Sem um formatador, os agentes usam Intl e a localidade do leitor.
  • Dinheiro por mercado. A moeda que cada mercado utiliza para pagamentos. Cada mercado começa com a moeda própria da sua região.

Mercados exibe todos os mercados lado a lado: números, dinheiro, data, hora, dia em que a semana começa, distância rodoviária e tamanho do papel. Todos esses elementos usam o mesmo momento e valores. Os valores diferentes do mercado de origem aparecem destacados em tinta preta.

Abra um mercado para ver o restante:

GrupoO que é exibido
Calendário e horárioCalendários em uso e a mesma data em cada um deles, relógio de 12 ou 24 horas, primeiro dia da semana, fim de semana, como as semanas são numeradas
Números e dinheiroDígitos, um número, uma porcentagem e um preço
Medidas e papelSistema métrico, sistema norte-americano ou ambos; distância rodoviária, temperatura, altura e peso corporal; A4 ou Letter
Pessoas e textoSe os sobrenomes vêm primeiro, números de telefone em formato nacional e internacional, códigos postais com exemplos, direção do texto, como as listas são concatenadas e como o texto é ordenado
EndereçoUm endereço conforme escrito pelos correios nesse mercado, também em escrita latina quando o mercado usa outro alfabeto; quais campos são obrigatórios ou devem ser escritos em maiúsculas; e como o mercado denomina cada campo

Altere o formatador e o dinheiro por mercado no passo "Cultura" do assistente de Cultura do assistente (Alterar no assistente). As escolhas são gravadas no arquivo de configuração como world.formatter e world.currencies, e requer a versão 1.14.0 ou posterior da CLI; o assistente move um pino mais antigo.

O que é informado aos agentes

Os agentes de desenvolvimento que trabalham em um projeto internacionalizado recebem o formatador e, para cada mercado, apenas o que difere do mercado de origem: sua moeda, calendários, dígitos, relógio, início e fim de semana, papel, unidades, ordem dos nomes, direção do texto e códigos postais. Também são instruídos a manter os códigos postais e números de telefone como texto, armazenar os números de telefone no formato E.164, registrar um nome em um único campo a menos que o mercado exija suas partes e aceitar todos os scripts na validação.