Intl.ListFormat() コンストラクター
Intl.ListFormat()
コンストラクターは、言語を考慮したリストの書式化を可能にする
Intl.ListFormat
オブジェクトを生成します。
試してみましょう
構文
js
new Intl.ListFormat();
new Intl.ListFormat(locales);
new Intl.ListFormat(locales, options);
引数
locales
省略可-
BCP 47 言語タグの文字列、または、そのような文字列の配列です。
locales
引数の一般的な形式と解釈は、 Intl のページを参照してください。 options
省略可-
以下のプロパティの一部またはすべてを持つオブジェクトです。
localeMatcher
-
使用するロケール照合アルゴリズム。取りうる値は以下の通りです。
- "
best fit
" (既定値) -
"
lookup
" このオプションについての詳細は、 Intl のページをご覧ください。
- "
type
-
グループ化の種類を示します。取りうる値は以下の通りです。
- "
conjunction
" - リスト項目の "and" ベースのグループ化: "A, B, and C" (既定値) - "
disjunction
" - リスト項目の "or" ベースのグループ化: "A, B, or C" - "
unit
" - リスト項目の単位としてのグループ化("and" ベースでも "or" ベースでもない): "A, B, C"
- "
style
-
グループ化のスタイルを示します(例えば、リストの区切り文字や結合などが含まれます)。取りうる値は以下の通りです。
- "
long
": "A, B, and C" (既定値) - "
short
": "A, B, C" - "
narrow
": "A B C"
- "
例
format の使用
次の例では、英語を使用するリストのフォーマッターを生成する方法を示します。
js
const list = ["Motorcycle", "Bus", "Car"];
console.log(
new Intl.ListFormat("en-GB", { style: "long", type: "conjunction" }).format(
list,
),
);
// Motorcycle, Bus and Car
console.log(new Intl.ListFormat("en-GB", { style: "long" }).format(list));
// Motorcycle, Bus and Car
console.log(new Intl.ListFormat("en-US", { style: "long" }).format(list));
// Motorcycle, Bus, and Car
console.log(
new Intl.ListFormat("en-GB", { style: "short", type: "conjunction" }).format(
list,
),
);
// Motorcycle, Bus and Car
console.log(
new Intl.ListFormat("en-US", { style: "short", type: "conjunction" }).format(
list,
),
);
// Motorcycle, Bus, & Car
console.log(
new Intl.ListFormat("en-GB", { style: "narrow", type: "conjunction" }).format(
list,
),
);
// Motorcycle, Bus, Car
console.log(
new Intl.ListFormat("en-GB", { style: "long", type: "disjunction" }).format(
list,
),
);
// Motorcycle, Bus or Car
console.log(
new Intl.ListFormat("en-GB", { style: "short", type: "disjunction" }).format(
list,
),
);
// Motorcycle, Bus or Car
console.log(
new Intl.ListFormat("en-GB", { style: "narrow", type: "disjunction" }).format(
list,
),
);
// Motorcycle, Bus or Car
console.log(new Intl.ListFormat("en-US", { style: "narrow" }).format(list));
// Motorcycle, Bus, Car
console.log(
new Intl.ListFormat("en-GB", { style: "narrow", type: "unit" }).format(list),
);
// Motorcycle Bus Car
console.log(
new Intl.ListFormat("en-US", { style: "long" }).format([
"30 degrees",
"15 minutes",
"50 seconds",
]),
);
// 30 degrees, 15 minutes, and 50 seconds
console.log(
new Intl.ListFormat("en-US", { style: "narrow" }).format([
"30 degrees",
"15 minutes",
"50 seconds",
]),
);
// 30 degrees, 15 minutes, 50 seconds
console.log(
new Intl.ListFormat("en-US", { style: "narrow", type: "unit" }).format([
"30°",
"15′",
"50″",
]),
);
// 30° 15′ 50″
仕様書
Specification |
---|
ECMAScript Internationalization API Specification # sec-intl-listformat-constructor |
ブラウザーの互換性
BCD tables only load in the browser