コアマクロ

コアマクロは、JavaScript 側で使う Lingui マクロです。

役割は大きく 2 つあります。

公式 Lingui では、これに当たるのが t、msg、defineMessage、plural、select、selectOrdinal です。 lingui-for では、これらの意味論を保ちながら、必要な箇所だけフレームワークの構文に合わせています。

コアマクロの概要

メッセージを即座に翻訳し、文字列を返します

プレビュー

こんにちは、Lingui

スニペット

<p>{
  $t\`Hello \${name}\`
}</p>

msg / defineMessage

記述子を定義し、後で翻訳します

プレビュー

お帰りなさい、Lingui

スニペット

<script lang="ts">
  let welcome = $derived(msg\`Welcome back, \${name}\`);
</script>

<p>{$t(welcome)}</p>

plural

数値に基づいて複数のカテゴリからテキストを選択します

プレビュー

3個の項目

スニペット

<p>{
  $plural(count, {
    one: "# item",
    other: "# items",
  })
}</p>

select

トーンやステータスなどの名前付きケースでテキストを切り替えます

プレビュー

ようこそ

スニペット

<p>{
  $select(tone, {
    formal: "Welcome",
    casual: "Hi",
    other: "Hello",
  })
}</p>

selectOrdinal

1番目、2番目、3番目などの序数テキストを選択します

プレビュー

2番目

スニペット

<p>{
  $selectOrdinal(place, {
    one: "#st",
    two: "#nd",
    few: "#rd",
    other: "#th",
  })
}</p>

まずここから始めるべき場面

次のような場合は、コアマクロから始めてください。