Construtor Intl.ListFormat()

O construtor Intl.ListFormat() cria objetos Intl.ListFormat que habilitam a formatação de lista de acordo com o idioma.

Experimente

Sintaxe

js
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"). quando style é "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.

js
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 Internationalization API Specification
# sec-intl-listformat-constructor

Compatibilidade de browsers

BCD tables only load in the browser

Veja também