Construtor Intl.ListFormat()
Baseline Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since April 2021.
O construtor Intl.ListFormat()
cria objetos
Intl.ListFormat
que habilitam a formatação de lista de acordo com o idioma.
Experimente
const vehicles = ["Motorcycle", "Bus", "Car"];
const formatter = new Intl.ListFormat("en", {
style: "long",
type: "conjunction",
});
console.log(formatter.format(vehicles));
// Expected output: "Motorcycle, Bus, and Car"
const formatter2 = new Intl.ListFormat("de", {
style: "short",
type: "disjunction",
});
console.log(formatter2.format(vehicles));
// Expected output: "Motorcycle, Bus oder Car"
const formatter3 = new Intl.ListFormat("en", { style: "narrow", type: "unit" });
console.log(formatter3.format(vehicles));
// Expected output: "Motorcycle Bus Car"
Sintaxe
new Intl.ListFormat();
new Intl.ListFormat(locales);
new Intl.ListFormat(locales, options);
Parâmetros
locales
Optional-
Uma string com a tag de idioma BCP 47, ou um array de tais string. Veja de forma geral a interpretação do argumento
locales
, na página Intl. options
Optional-
Um objeto com algumas ou todas as seguintes propriedades:
localeMatcher
-
O algoritmo de correspondência de localidade para ser utilizado. Os possíveis valores são "
lookup
" e "best fit
"; o valor padrão é "best fit
". Para mais informações sobre esta opção, veja a página Intl. type
-
O formato de saída da mensagem. Os possíveis valores são "
conjunction
" que representa listas com "e" (padrão, e.g., "A, B, e C
"), ou "disjunction
" que representa listas com "ou" (e.g., "A, B, ou C
"). "unit
" que representa listas com valores de unidade (e.g., "5 libras, 12 onças
"). style
-
O tamanho da lista formatada. Os possíveis valores são: "
long
" (padrão, e.g., "A, B, e C
"); "short
" (e.g., "A, B, C
"), ou "narrow
" (e.g., "A B C
"). quandostyle
é "short
" ou "narrow
", "unit
" é o único valor de tipo permitido.
Exemplos
Utilizando format
O exemplo a seguir mostra como criar um List formatter utilizando o idioma Português.
const list = ["Moto", "Ônibus", "Carro"];
console.log(
new Intl.ListFormat("pt-BR", { style: "long", type: "conjunction" }).format(
list,
),
);
// > Moto, Ônibus e Carro
console.log(
new Intl.ListFormat("pt-BR", { style: "short", type: "disjunction" }).format(
list,
),
);
// > Moto, Ônibus ou Carro
console.log(
new Intl.ListFormat("pt-BR", { style: "narrow", type: "unit" }).format(list),
);
// > Moto Ônibus Carro
Especificações
Specification |
---|
ECMAScript® 2026 Internationalization API Specification # sec-intl-listformat-constructor |