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.
- Prontidão mundialCódigo que presume um idioma
- CulturaO que cada mercado espera
- Visão geralO status de cada idioma
- StringsTodas as strings em todos os idiomas
- SugestõesAguardando decisão
- TrocarArquivos para outras ferramentas
- ColaboradoresQuem pode sugerir redação
- AutomaçõesTrabalho noturno e no merge
- ConfiguraçõesIdiomas, acesso e custos
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.
Concluído: 3f2c9a1 há 2 horas
- 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
- src/components/checkout/summary.tsxTexto escrito diretamente no código: 18 · Número formatado sem a localidade: 418
- 42:9
Resumo do pedido
- 57:13
Frete grátis em todo pedido
- 61:11
Aplicar código
- 42:9
- src/app/account/page.tsxTexto escrito diretamente no código: 11 · Frase montada a partir de partes: 211
- 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.
- Prontidão mundialCódigo que presume um idioma
- CulturaO que cada mercado espera
- Visão geralO status de cada idioma
- StringsTodas as strings em todos os idiomas
- SugestõesAguardando decisão
- TrocarArquivos para outras ferramentas
- ColaboradoresQuem pode sugerir redação
- AutomaçõesTrabalho noturno e no merge
- ConfiguraçõesIdiomas, acesso e custos
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.
- Formatador
- Formatador do next-intl
useFormatter from next-intl - Dinheiro por mercado
- alemão: EUR · japonês: JPY · árabe: SAR · sueco: SEK
| Mercado | Números | Dinheiro | Data | Horário | Semana começa | Papel |
|---|---|---|---|---|---|---|
| inglêsen-US · Fonte | 12,345.678 | $1,299.50 | 3/14/26 | 4:05 PM | dom. | Letter |
| alemãode-DE | 12.345,678 | 1.299,50 € | 14.03.26 | 16:05 | seg. | A4 |
| japonêsja-JP | 12,345.678 | ¥1,300 | 2026/03/14 | 16:05 | dom. | A4 |
| árabear-SA | ١٢٬٣٤٥٫٦٧٨ | ١٬٢٩٩٫٥٠ ر.س. | ١٤/٣/٢٠٢٦ | ٤:٠٥ م | dom. | A4 |
| suecosv-SE | 12 345,678 | 1 299,50 kr | 2026-03-14 | 16:05 | seg. | 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 usamIntle 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:
| Grupo | O que é exibido |
|---|---|
| Calendário e horário | Calendá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 dinheiro | Dígitos, um número, uma porcentagem e um preço |
| Medidas e papel | Sistema métrico, sistema norte-americano ou ambos; distância rodoviária, temperatura, altura e peso corporal; A4 ou Letter |
| Pessoas e texto | Se 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ço | Um 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.