localization
title: Localização sidebar_position: 9
Visão Geral
Este guia aborda a estratégia abrangente de internacionalização (i18n) e localização para a Biblioteca de Componentes Raaghu, permitindo alcance global com suporte a múltiplos idiomas, culturas e regiões.
Filosofia de i18n
Nossa abordagem de internacionalização baseia-se nos seguintes princípios centrais:
- Design Universal: Construir componentes que funcionem perfeitamente em todas as culturas e idiomas
- Performance em Primeiro Lugar: Carregamento preguiçoso (lazy loading) das traduções e gerenciamento eficiente dos bundles
- Experiência do Desenvolvedor: APIs simples que tornam a integração de i18n descomplicada
- Sensibilidade Cultural: Suporte a convenções e preferências culturais diversas
- Acessibilidade: Garantir que i18n não comprometa recursos de acessibilidade
Visão geral da arquitetura
Pilha principal de i18n
{
"react-i18next": "^15.2.0",
"i18next": "^24.2.0",
"i18next-browser-languagedetector": "^8.0.2",
"i18next-http-backend": "^3.0.2",
"i18next-icu": "^2.3.0"
}
Ferramentas adicionais
{
"i18next-scanner": "^4.5.0",
"i18next-parser": "^9.0.2",
"@formatjs/intl": "^2.10.10",
"date-fns": "^4.8.0",
"react-hook-form": "^7.54.2"
}
Idiomas suportados
Idiomas principais (Suporte completo)
| Idioma | Código | RTL | Status | Cobertura |
|---|---|---|---|---|
| Inglês | en | Não | ✅ Concluído | 100% |
| Espanhol | es | Não | ✅ Concluído | 100% |
| Francês | fr | Não | ✅ Concluído | 100% |
| Alemão | de | Não | ✅ Concluído | 100% |
| Chinês (Simplificado) | zh-CN | Não | ✅ Concluído | 100% |
| Japonês | ja | Não | ✅ Concluído | 100% |
| Árabe | ar | Sim | ✅ Concluído | 100% |
| Hebraico | he | Sim | ✅ Concluído | 100% |
Idiomas secundários (Suporte parcial)
| Idioma | Código | RTL | Status | Cobertura |
|---|---|---|---|---|
| Português | pt | Não | 🚧 Em andamento | 80% |
| Italiano | it | Não | 🚧 Em andamento | 75% |
| Russo | ru | Não | 🚧 Em andamento | 70% |
| Coreano | ko | Não | 📋 Planejado | 0% |
| Hindi | hi | Não | 📋 Planejado | 0% |