国際化とローカライゼーション

node ace add @adonisjs/i18n

import app from '@adonisjs/core/services/app'
import { defineConfig, formatters, loaders } from '@adonisjs/i18n'

const i18nConfig = defineConfig({
  defaultLocale: 'en',
  formatter: formatters.icu(),

  loaders: [
    loaders.fs({
      location: app.languageFilesPath()
    })
  ],
})

export default i18nConfig

resources
├── lang
│   ├── en
│   └── fr

resources
├── lang
│   ├── en
│   ├── en-us
│   ├── en-uk

resources
├── lang
│   ├── en
│   │   └── messages.json
│   └── fr
│       └── messages.json

{
  "greeting": "Hello world"
}

{
  "greeting": "Bonjour le monde"
}

import i18nManager from '@adonisjs/i18n/services/main'

// 英語用のI18nインスタンス
const en = i18nManager.locale('en')

// フランス語用のI18nインスタンス
const fr = i18nManager.locale('fr')

const i18n = i18nManager.locale('en')
i18n.t('messages.greeting') // Hello world

const i18n = i18nManager.locale('fr')
i18n.t('messages.greeting') // Bonjour le monde

export default defineConfig({
  fallbackLocales: {
    'de-CH': 'de',
    'fr-CH': 'fr'
  }
})

const i18n = i18nManager.locale('de-CH')
i18n.fallbackLocale // de（フォールバックコレクションを使用）

const i18n = i18nManager.locale('fr-CH')
i18n.fallbackLocale // fr（フォールバックコレクションを使用）

const i18n = i18nManager.locale('en')
i18n.fallbackLocale // en（デフォルトのロケールを使用）

const i18n = i18nManager.locale('en')

i18n.t('messages.hero_title')
// translation missing: en, messages.hero_title

const fallbackValue = ''
i18n.t('messages.hero_title', fallbackValue)
// 出力: ''

import { defineConfig } from '@adonisjs/i18n'

export default defineConfig({
  fallback: (identifier, locale) => {
  return ''
  },
})

import { HttpContext } from '@adonisjs/core/http'

export default class PostsController {
  async store({ i18n, session }: HttpContext) {
    session.flash('success', {
      message: i18n.t('post.created')
    })
  }
}

<h1> {{ t('messages.heroTitle') }} </h1>

export default class DetectUserLocaleMiddleware {
  static {
    RequestValidator.messagesProvider = (ctx) => {
      return ctx.i18n.createMessagesProvider()
    }
  }
}

{
  "shared": {
    "fields": {
      "first_name": "first name"
    },
    "messages": {
      "required": "Enter {field}",
      "username.required": "Choose a username for your account",
      "email": "The email must be valid"
    }
  }
}

{
  "shared": {
    "fields": {
      "first_name": "Prénom"
    },
    "messages": {
      "required": "Remplisser le champ {field}",
      "username.required": "Choissisez un nom d'utilisateur pour votre compte",
      "email": "L'email doit être valide"
    }
  }
}

import { createJobValidator } from '#validators/jobs'
import i18nManager from '@adonisjs/i18n/services/main'

/**
 * 特定のロケールに対する i18n インスタンスを取得します。
 */
const i18n = i18nManager.locale('fr')

await createJobValidator.validate(data, {
  /**
   * 翻訳を使用するためのメッセージプロバイダを登録します。
   */
  messagesProvider: i18n.createMessagesProvider()
})

{
  "greeting": "こんにちは { username }"
}

{{ t('messages.greeting', { username: 'Virk' }) }}

{
  "greeting": "<p> こんにちは { username } </p>"
}

{{{ t('messages.greeting', { username: 'Virk' }) }}}

{
  "bagel_price": "このベーグルの価格は {amount, number, ::currency/USD} です"
}

{{ t('bagel_price', { amount: 2.49 }) }}

このベーグルの価格は $2.49 です

ポールの長さ: {price, number, ::measure-unit/length-meter}

口座残高: {price, number, ::currency/USD compact-long}

{
  "shipment_update": "ご注文の商品は {expectedDate, date, medium} に到着予定です"
}

{{ t('shipment_update', { expectedDate: luxonDateTime }) }}

ご注文の商品は 2023年10月16日 に到着予定です

{
  "appointment": "今日は {appointmentAt, time, ::h:m a} に予約があります"
}

今日は 午後2:48 に予約があります

cart_summary:
  "カートには {itemsCount, plural,
    =0 {アイテムはありません}
    one {1つのアイテム}
    other {#個のアイテム}
  } があります"

{{ t('messages.cart_summary', { itemsCount: 1 }) }}

カートには 1つのアイテム があります

{{ t('messages.cart_summary', { itemsCount: 1000 }) }}

{{-- 出力 --}}
{{-- カートには 1,000個のアイテム があります --}}

auto_reply:
  "{gender, select,
    male {彼}
    female {彼女}
    other {彼ら}
  } がすぐに返信します。"

{{ t('messages.auto_reply', { gender: 'female' }) }}

彼女 がすぐに返信します。

anniversary_greeting:
  "私の {years, selectordinal,
    one {#周年}
    two {#周年}
    few {#周年}
    other {#周年}
  } です"

{{ t('messages.anniversary_greeting', { years: 2 }) }}

私の 2周年 です

import i18nManager from '@adonisjs/i18n/services/main'

i18nManager
  .locale('en')
  .formatNumber(123456.789, {
    maximumSignificantDigits: 3
  })

import i18nManager from '@adonisjs/i18n/services/main'

i18nManager
  .locale('en')
  .formatCurrency(200, {
    currency: 'USD'
  })

import i18nManager from '@adonisjs/i18n/services/main'
import { DateTime } from 'luxon'

i18nManager
  .locale('en')
  .locale('en')
  .formatDate(new Date(), {
    dateStyle: 'long'
  })

// もっともluxonの日時インスタンスをフォーマットする
i18nManager
  .locale('en')
  .formatDate(DateTime.local(), {
    dateStyle: 'long'
  })

import i18nManager from '@adonisjs/i18n/services/main'

i18nManager
  .locale('en')
  .formatTime(new Date())

import { DateTime } from 'luxon'
import i18nManager from '@adonisjs/i18n/services/main'

const luxonDate = DateTime.local().plus({ hours: 2 })

i18nManager
  .locale('en')
  .formatRelativeTime(luxonDate, 'hours')

const luxonDate = DateTime.local().plus({ hours: 2 })

I18n
  .locale('en')
  .formatRelativeTime(luxonDate, 'auto')

// 2時間後 👈

const luxonDate = DateTime.local().plus({ hours: 200 })

I18n
  .locale('en')
  .formatRelativeTime(luxonDate, 'auto')

// 8日後 👈

import i18nManager from '@adonisjs/i18n/services/main'

i18nManager.i18nManager('en').formatPlural(0)
// other

i18nManager.i18nManager('en').formatPlural(1)
// one

i18nManager.i18nManager('en').formatPlural(2)
// other

import i18nManager from '@adonisjs/i18n/services/main'

i18nManager
  .locale('en')
  .formatList(['Me', 'myself', 'I'], { type: 'conjunction' })

// Me, myself and I

import i18nManager from '@adonisjs/i18n/services/main'

i18nManager
  .locale('en')
  .formatList(['5 hours', '3 minutes'], { type: 'unit' })

// 5 hours, 3 minutes

import i18nManager from '@adonisjs/i18n/services/main'

i18nManager
  .locale('en')
  .formatDisplayNames('INR', { type: 'currency' })

// Indian Rupee

import i18nManager from '@adonisjs/i18n/services/main'

i18nManager
  .locale('en')
  .formatDisplayNames('en-US', { type: 'language' })

// American English

mkdir .vscode

touch .vscode/i18n-ally-custom-framework.yml
touch .vscode/settings.json

{
  "i18n-ally.localesPaths": [
    "resources/lang"
  ],
  "i18n-ally.keystyle": "nested",
  "i18n-ally.namespace": true,
  "i18n-ally.editor.preferEditor": true,
  "i18n-ally.refactor.templates": [
    {
      "templates": [
        "{{ t('{key}'{args}) }}"
      ],
      "include": [
        "**/*.edge",
      ],
    },
  ]
}

languageIds:
  - edge
usageMatchRegex:
  - "[^\\w\\d]t\\(['\"`]({key})['\"`]"
sortKeys: true

import emitter from '@adonisjs/core/services/emitter'

emitter.on('i18n:missing:translation', function (event) {
  console.log(event.identifier)
  console.log(event.hasFallback)
  console.log(event.locale)
})

import i18nManager from '@adonisjs/i18n/services/main'

await i18nManager.reloadTranslations()

import type {
  LoaderFactory,
  TranslationsLoaderContract,
} from '@adonisjs/i18n/types'

/**
 * 設定のためのTypeScriptの型
 */
export type DbLoaderConfig = {
  connection: string
  tableName: string
}

/**
 * ローダーの実装
 */
export class DbLoader implements TranslationsLoaderContract {
  constructor(public config: DbLoaderConfig) {
  }

  async load() {
    return {
      en: {
        'messages.greeting': 'Hello world',
      },
      fr: {
        'messages.greeting': 'Bonjour le monde',
      }
    }
  }
}

/**
 * ファクトリ関数を使用してローダーを参照する
 * 設定ファイル内でローダーを参照するためのものです。
 */
export function dbLoader(config: DbLoaderConfig): LoaderFactory {
  return () => {
    return new DbLoader(config)
  }
}

import { defineConfig } from '@adonisjs/i18n'
import { dbLoader } from 'my-custom-package'

const i18nConfig = defineConfig({
  loaders: [
    dbLoader({
      connection: 'pg',
      tableName: 'translations'
    })
  ]
})

import type {
  FormatterFactory,
  TranslationsLoaderContract,
} from '@adonisjs/i18n/types'

/**
 * フォーマッタの実装
 */
export class FluentFormatter implements TranslationsFormatterContract {
  format(
    message: string,
    locale: string,
    data?: Record<string, any>
  ): string {
    // フォーマットされた値を返す
  }
}

/**
 * ファクトリ関数を使用してフォーマッタを参照する
 * 設定ファイル内でフォーマッタを参照するためのものです。
 */
export function fluentFormatter(): FormatterFactory {
  return () => {
    return new FluentFormatter()
  }
}

import { defineConfig } from '@adonisjs/i18n'
import { fluentFormatter } from 'my-custom-package'

const i18nConfig = defineConfig({
  formatter: fluentFormatter()
})