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
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 Internationalization API Specification # sec-intl-listformat-constructor |
Compatibilidade de browsers
BCD tables only load in the browser