selectOrdinal

selectOrdinal は、ICU の序数選択メッセージのためのコアマクロです。 同じロジックには、コンポーネントマクロ形式の SelectOrdinal もあります。

文言が 1st、2nd、3rd のような序数カテゴリに依存する場合に使ってください。 単独で翻訳済み文字列を生成することもできますし、序数部分がより大きなメッセージの一部であるなら t`...` テンプレートリテラルの中に埋め込むこともできます。

フレームワークに依存しない Lingui の意味論については、公式の selectOrdinal リファレンス を参照してください。

ソース

Demo.svelte カタログ

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

#: src/demos/macros/select-ordinal/Demo.svelte
msgid "{place, selectordinal, one {#st} two {#nd} few {#rd} other {#th}}"
msgstr "{place, selectordinal, one {#st} two {#nd} few {#rd} other {#th}}"

結果

プレビュー 変換されたSvelte コンパイルされたカタログ

2nd

<p>
  {$__l4s_translate(
  /*i18n*/ {
    id: "foaSz6",
    values: {
      place: place
    }
  })}
</p>

/*eslint-disable*/
import type { Messages } from "@lingui/core";
export const messages = JSON.parse(
  "{\"foaSz6\":[[\"place\",\"selectordinal\",{\"one\":[\"#\",\"st\"],\"two\":[\"#\",\"nd\"],\"few\":[\"#\",\"rd\"],\"other\":[\"#\",\"th\"]}]]}",
) as Messages;

ロケール

EN JA

順位

使い方

Svelte

<script lang="ts">
  import { selectOrdinal, t } from "lingui-for-svelte/macro";

  let place = $state(2);
</script>

<!-- 単独使用: 序数字符列を直接生成する -->
<p>
  {$selectOrdinal(place, {
    one: "#st",
    two: "#nd",
    few: "#rd",
    other: "#th",
  })}
</p>

<!-- 埋め込み: selectOrdinal はより大きな翻訳単位の一部 -->
<p>
  {$t`Ranked ${selectOrdinal(place, {
    one: "#st",
    two: "#nd",
    few: "#rd",
    other: "#th",
  })}`}
</p>

.svelte ファイルでは、単独でリアクティブに使うなら $selectOrdinal を使います。 $t`...` の中にネストする場合は、$ 接頭辞なしの selectOrdinal を使います。

完全な説明と selectOrdinal.eager というエスケープハッチについては リアクティブマクロ を参照してください。

Astro

---
import { selectOrdinal, t } from "lingui-for-astro/macro";

const place = 2;
---

<!-- 単独使用: 序数字符列を直接生成する -->
<p>
  {
    selectOrdinal(place, {
      one: "#st",
      two: "#nd",
      few: "#rd",
      other: "#th",
    })
  }
</p>

<!-- 埋め込み: selectOrdinal はより大きな翻訳単位の一部 -->
<p>
  {
    t`Ranked ${selectOrdinal(place, {
      one: "#st",
      two: "#nd",
      few: "#rd",
      other: "#th",
    })}`
  }
</p>

Official Lingui

import { selectOrdinal, t } from "@lingui/core/macro";

// 単独使用
const label: string = selectOrdinal(place, {
  one: "#st",
  two: "#nd",
  few: "#rd",
  other: "#th",
});

// 埋め込み
const message: string = t`Ranked ${selectOrdinal(place, {
  one: "#st",
  two: "#nd",
  few: "#rd",
  other: "#th",
})}`;

完全一致

厳密な値に一致させるには、数値キーをそのまま使います。 完全一致はカテゴリキーより優先されます。

selectOrdinal(place, {
  1: "1st",
  2: "2nd",
  3: "3rd",
  other: "#th",
});

コンポーネントマクロ SelectOrdinal では、同じ一致をアンダースコア付きプロパティ（_1="1st"）で表します。 関数形式では数値キーをそのまま使うので、アンダースコアは不要です。

selectOrdinal が向いている場面

• 出力が序数カテゴリに依存する
• 現在のファイルではコンポーネントプロパティより関数形式のほうが読みやすい
• 公式 Lingui Core と一貫した記述子意味論を使いたい