@formatjs/intl-listformat

What is @formatjs/intl-listformat?

The @formatjs/intl-listformat package is a JavaScript library that provides advanced list formatting capabilities. It allows developers to format lists according to the locale-specific conventions. This can include adjusting the list format for different languages and regions, handling conjunctions, disjunctions, and unit lists in a locale-aware manner.

What are @formatjs/intl-listformat's main functionalities?

Locale-aware formatting of conjunctions

This feature allows the formatting of lists using conjunctions (e.g., 'and' in English) according to the specified locale. It is useful for creating human-readable lists in user interfaces.

import { IntlListFormat } from '@formatjs/intl-listformat';

const formatter = new IntlListFormat('en', { style: 'long', type: 'conjunction' });
const formattedList = formatter.format(['Apple', 'Orange', 'Banana']);
console.log(formattedList); // Output: 'Apple, Orange, and Banana'

Locale-aware formatting of disjunctions

This feature supports formatting lists with disjunctions (e.g., 'or' in English), adapting to the locale's specific rules and preferences. It's particularly useful in contexts where choices are presented to users.

import { IntlListFormat } from '@formatjs/intl-listformat';

const formatter = new IntlListFormat('en', { style: 'long', type: 'disjunction' });
const formattedList = formatter.format(['Apple', 'Orange', 'Banana']);
console.log(formattedList); // Output: 'Apple, Orange, or Banana'

Locale-aware formatting of unit lists

This feature is designed for formatting lists of units, making it easier to display measurements and other unit-based data in a way that conforms to local customs.

import { IntlListFormat } from '@formatjs/intl-listformat';

const formatter = new IntlListFormat('en', { style: 'short', type: 'unit' });
const formattedList = formatter.format(['1 lb', '12 oz']);
console.log(formattedList); // Output: '1 lb, 12 oz'

Other packages similar to @formatjs/intl-listformat

intl-list-format

This package also provides functionality for formatting lists based on locale settings. It is similar to @formatjs/intl-listformat but may not have as extensive support for different locales or customization options.

README

Intl ListFormat

We've migrated the docs to https://formatjs.io/docs/polyfills/intl-listformat.