言語の切り替え
今のページを別の言語で開き直すリンクを作ります。選んだ言語をCookieに書いて、次に/を開いたときに使えるようにします。
このページの内容
切り替え先のURL
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 "/")。
切り替え先の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'
試してみる
- 最初に入っている
/ja/products/42では、localeがja、pathnameが/products/42になります。enへの切り替え先は/en/products/42です。 /englishに書き換えると、先頭の区間がロケールではないので、localeがnullになります。/en/に書き換えると、pathnameは/になります。productsのように/で始まらない値に書き換えると、localizeが出すTypeErrorのエラー文を表示します。
切り替えのリンク
src/components/language-switcher.tsximport 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.tsimport 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を読みます。その書き方も、最初の言語を見てください。