# @nimbos/i18n
> Pacote de i18n para o projeto nimbos
Latest version **0.1.12** (published 2019-02-12) · ISC license · 0 weekly downloads
## Install
```sh
npm install @nimbos/i18n
pnpm add @nimbos/i18n
yarn add @nimbos/i18n
bun add @nimbos/i18n
```
## Health
**Score 15/100 (F)** — status: abandoned.
Positive: no vulnerabilities.
Warnings: low downloads; no types; no esm support; pre 1.0.
Negative: abandoned; low maintenance score.
## Facts
| | |
|---|---|
| Version | 0.1.12 |
| Published | 2019-02-12 |
| First published | 2018-10-30 |
| Weekly downloads | 0 |
| License | ISC |
| TypeScript types | none |
| Module format | CommonJS |
| Dependencies | 2 |
| Unpacked size | 11.4 KB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| GitHub stars | 2 |
| Author | castrolol |
| Maintainers | castrolol, jossanpetrenko, luannuvem |
## Links
- npm: https://www.npmjs.com/package/@nimbos/i18n
- Repository: https://github.com/JossanPetrenko/spa-framework
- Homepage: https://github.com/JossanPetrenko/spa-framework#readme
- Issues: https://github.com/JossanPetrenko/spa-framework/issues
- npm.io page: https://npm.io/package/@nimbos/i18n
## Dependencies (2)
- [flat](https://npm.io/package/flat.md) ^4.1.0
- [string-template](https://npm.io/package/string-template.md) ^1.0.0
## Recent versions
- 0.1.12 (latest) — 2019-02-12
- 0.1.1-alpha.0 (canary) — 2018-10-30
- 0.1.11 — 2019-02-12
- 0.1.10 — 2018-12-06
- 0.1.9 — 2018-12-06
- 0.1.8 — 2018-11-24
- 0.1.7 — 2018-11-24
- 0.1.6 — 2018-11-24
- 0.1.5 — 2018-11-23
- 0.1.4 — 2018-11-23
- 0.1.3 — 2018-11-22
- 0.1.2 — 2018-10-30
- 0.1.1 — 2018-10-30
## README
# `@nimbos/i18n`
# **Internationalization**
A função de internacionalização permite salvar as _strings_
do sistema de maneira centralizada e manutenivel alem de permitir
a mudança de linguagem em _runtime_.
## Uso Básico
Após regisdtrar um conjunto de chaves
```js
import t from '@nimbos/i18n';
//registrando
t.register('pt-BR', {
hello_world: 'Olá Mundo'
});
```
O uso pode ser feito da seguinte forma
```js
import t from '@nimbos/i18n';
const localized = t('hello_world');
console.log(localized); //Olá Mundo
```
## Váriaveis
Para cenários onde existem váriaveis dentro das mensagem, elas podem ser definidas
como váriaveis (nomeadas) e parametros (numerados).
Como no exemplo:
```js
import t from '@nimbos/i18n';
//registrando
t.register('pt-BR', {
hello_world: 'Olá {name}'
});
```
O uso pode ser feito da seguinte forma
```js
import t from '@nimbos/i18n';
const localized = t('hello_world', { name: 'Mundo' });
console.log(localized); //Olá Mundo
```
## Parametros
Exemplo de uso com parametros:
```js
import t from '@nimbos/i18n';
//registrando
t.register('pt-BR', {
hello_world: 'Olá {0}' //o nomero é sequencial, {1}, {2}, {3}...
});
```
O uso pode ser feito da seguinte forma
```js
import t from '@nimbos/i18n';
let parametro = 'Mundo';
const localized = t('hello_world', parametro);
console.log(localized); //Olá Mundo
```
> Esse modo é menos legivel e pode gerar confusões, use com cautela
## Contagem Inteligente
Para cenários onde temos contagem de elementos, podemos usar
a variavel ou parametro para contagem
Exemplo:
```js
import t from '@nimbos/i18n';
//registrando
t.register('pt-BR', {
items_count: ['Sem Items!', 'Apenas um Item!', 'São {count} Items!']
});
```
O uso pode ser feito da seguinte forma
```js
import t from '@nimbos/i18n';
const localizedNone = t('hello_world', { count: 0 });
const localizedOne = t('hello_world', { count: 1 });
const localizedMany = t('hello_world', { count: 2 });
console.log(localizedNone); //Sem Items!
console.log(localizedOne); //Apenas um Item!
console.log(localizedMany); //São 2 Items!
```
> O número de items acompanha os items do array, se existirem 4 items, por exemplo,
> será o primeiro para **0** o segundo para **1** o terceiro para **2** e o quarto para todos os outros
> O mesmo ocorreria para **2** itens, o primeiro para **0** e o segundo para todos os outros
A contagem inteligente funciona para as props com os seguintes nomes:
- **count**
- **number**
- **size**
- **length**
- **items**
Ou para o primeiro item de um _array_
## Mudança de linguagem
Exemplo de uso com varios idiomas:
```js
import t from '@nimbos/i18n';
//registrando
t.register('pt-BR', {
hello_world: 'Olá Mundo' //o nomero é sequencial, {1}, {2}, {3}...
});
//registrando
t.register('en-US', {
hello_world: 'Hello World' //o nomero é sequencial, {1}, {2}, {3}...
});
```
O uso pode ser feito da seguinte forma
```js
import t from '@nimbos/i18n';
let parametro = 'Mundo';
const localizedPTBR = t('hello_world');
t.lang('en-US');
const localizedENUS = t('hello_world');
console.log(localizedPTBR); //Olá Mundo
console.log(localizedENUS); //Hello World
```
## Exemplo no React
Pode ser usado como função:
```jsx
import t from '@nimbos/i18n'