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
을 반환합니다.
시도해보기
구문
formatToParts(list)
매개변수
반환 값
목록의 형식화된 부분을 포함하는 구성 요소의 Array
.
설명
Intl.ListFormat.prototype.format()
가
주어진 로케일과 스타일 옵션에 따라 형식이 맞춰진
목록의 문자열 버전을 반환하지만,
formatToParts()
는 형식이 맞춰진 문자열의
다양한 구성 요소를 배열로 반환합니다.
결과 배열의 각 요소는 type
과 value
두 가지 속성을 가집니다.
type
속성은 목록의 값을 나타내는 "element"
나
언어적 구조를 나타내는 "literal"
중 하나일 수 있습니다.
value
속성은 토큰의 내용을
문자열로 제공합니다.
형식화에 사용되는 로케일과 스타일 옵션은 Intl.ListFormat
인스턴스를 생성할 때 지정됩니다.
예제
formatToParts 사용하기
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