Intl.ListFormat.prototype.formatToParts()

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.

Intl.ListFormat 인스턴스의 formatToParts() 메서드는 로케일을 고려하여 값의 목록을 형식화하는 데 사용할 수 있는 다양한 구성 요소를 나타내는 객체들의 Array을 반환합니다.

시도해보기

구문

js
formatToParts(list)

매개변수

list

Array와 같은 로케일에 따라 형식을 맞출 순회 가능한 객체.

반환 값

목록의 형식화된 부분을 포함하는 구성 요소의 Array.

설명

Intl.ListFormat.prototype.format()가 주어진 로케일과 스타일 옵션에 따라 형식이 맞춰진 목록의 문자열 버전을 반환하지만, formatToParts()는 형식이 맞춰진 문자열의 다양한 구성 요소를 배열로 반환합니다.

결과 배열의 각 요소는 type과 value 두 가지 속성을 가집니다. type 속성은 목록의 값을 나타내는 "element"나 언어적 구조를 나타내는 "literal" 중 하나일 수 있습니다. value 속성은 토큰의 내용을 문자열로 제공합니다.

형식화에 사용되는 로케일과 스타일 옵션은 Intl.ListFormat 인스턴스를 생성할 때 지정됩니다.

예제

formatToParts 사용하기

js
const fruits = ["Apple", "Orange", "Pineapple"];
const myListFormat = new Intl.ListFormat("en-GB", {
  style: "long",
  type: "conjunction",
});

console.table(myListFormat.formatToParts(fruits));
// [
//  { "type": "element", "value": "Apple" },
//  { "type": "literal", "value": ", " },
//  { "type": "element", "value": "Orange" },
//  { "type": "literal", "value": ", and " },
//  { "type": "element", "value": "Pineapple" }
// ]

명세서

Specification
ECMAScript Internationalization API Specification
# sec-Intl.ListFormat.prototype.formatToParts

브라우저 호환성

BCD tables only load in the browser

같이 보기