@k8ordo/i18n

言語の切り替え

今のページを別の言語で開き直すリンクを作ります。選んだ言語をCookieに書いて、次に/を開いたときに使えるようにします。

このページの内容

切り替え先のURL

ts
locales.delocalize('/ja/products/42');
// { locale: 'ja', pathname: '/products/42' }

locales.localize('/products/42', 'en');
// '/en/products/42'

delocalizeは、pathnameの先頭にあるロケールの区間を外します。localizeは、pathnameの先頭にロケールの区間を付けます。

先頭の区間がロケールでないとき、delocalizeはlocale: nullを返します。/englishのenglishもロケールとはみなしません。既定のロケールには置き換えません。どのロケールにするかは呼ぶ側で決めます。

/enと/en/から区間を外した残りは/です。反対に、localize('/', 'en')は/enを返します。

警告

落とし穴

localizeは、区間がすでに付いているかを確かめません。localize('/en/ui', 'ja')は/ja/en/uiになるので、delocalizeしたpathnameを渡します。/で始まらない値はTypeErrorになります(localize: "products" is not a pathname — it does not start with "/")。

Playground

切り替え先のURLのデモ

pathnameを入れると、delocalizeの結果と、各ロケールへlocalizeした結果を表示します。

delocalize('/ja/products/42')
{ locale: 'ja', pathname: '/products/42' }
localize('/products/42', 'ja')
'/ja/products/42'
localize('/products/42', 'en')
'/en/products/42'

試してみる

  1. 最初に入っている/ja/products/42では、localeがja、pathnameが/products/42になります。enへの切り替え先は/en/products/42です。
  2. /englishに書き換えると、先頭の区間がロケールではないので、localeがnullになります。
  3. /en/に書き換えると、pathnameは/になります。
  4. productsのように/で始まらない値に書き換えると、localizeが出すTypeErrorのエラー文を表示します。

切り替えのリンク

src/components/language-switcher.tsx
import type { Variants } from '@k8ordo/i18n';

import { locales } from '../i18n';

const NAMES: Variants<string> = { ja: '日本語', en: 'English' };

type Props = { pathname: string };

export function LanguageSwitcher({ pathname }: Props) {
  const rest = locales.delocalize(pathname).pathname;
今のpathnameからロケールの区間を外す
  const current = locales.getLocale();

  return (
    <ul>
      {locales.all.map((locale) => (
        <li key={locale}>
          <a
            aria-current={locale === current ? 'true' : undefined}
            href={locales.localize(rest, locale)}
各ロケールの区間を付けた切り替え先
            hrefLang={locale}
            lang={locale}
          >
            {NAMES[locale]}
          </a>
        </li>
      ))}
    </ul>
  );
}

切り替え先は、今のページのpathnameから作ります。pathnameはbaseを除いた形で、アプリのルーターから受け取ります。@k8ordo/routerのusePathname()が返す値は、そのまま渡せます。詳しくは@k8ordo/routerの現在地を見てください。

素の<a>で書けます。移動後の描画では、文言は新しいURLのロケールで読まれます。

Variants<string>は、Registerに登録されたロケールごとに1つずつ値を持つ型です。ロケールを足して言語名を書き忘れると、型エラーになります。

情報

メモ

localizeとdelocalizeはpathnameだけを扱うので、クエリ(?より後ろ)は切り替え先に付きません。残したいときは自分で付け足します。

Viteのbaseの下に置くアプリでは、localizeの結果にbaseを付けます。詳しくは今のロケールを見てください。

選んだ言語のCookie

src/lib/remember-locale.ts
import type { Locale } from '../i18n';

const MAX_AGE = 400 * 24 * 60 * 60 * 1000;

export const rememberLocale = (locale: Locale) =>
  cookieStore.set({
    name: 'locale',
    value: locale,
    sameSite: 'lax',
    expires: Date.now() + MAX_AGE,
  });

サーバーのnegotiateRequestは、このCookieをAccept-Languageより先に読みます。

src/components/language-switcher.tsx
<a
  aria-current={locale === current ? 'true' : undefined}
  href={locales.localize(rest, locale)}
  hrefLang={locale}
  lang={locale}
  onClick={() => {
クリックで書くので、切り替えはClient Componentにする
    void rememberLocale(locale);
  }}
>

Cookie Store APIの既定のままだと、Cookieはブラウザを閉じると消え、SameSite=Strictで書かれます。StrictのCookieは、ほかのサイトのリンクから来た最初のリクエストには付きません。そのためsameSite: 'lax'と、400日後のexpiresを付けます。ブラウザがCookieを保つのは、長くても400日です。

Cookieの名前はアプリが決めます。読む側のnegotiateRequestにも、同じ名前を{ cookie: 'locale' }のように渡します。読む側の書き方は最初の言語を見てください。

情報

メモ

サーバーの無いサイトでは、/のページがブラウザでCookieを読みます。その書き方も、最初の言語を見てください。

k8ordo

Baselineに入った機能を、制限なく使うReactのライブラリ群。