#포맷터

포맷터는 원본 데이터를 읽기 쉬운 텍스트로 변환하는 데 사용됩니다. 포맷터는 콜론(:)을 사용하여 데이터에 적용되며, 체인처럼 연결하여 호출할 수 있습니다. 이때 각 포맷터의 출력은 다음 포맷터의 입력이 됩니다. 일부 포맷터는 상수 매개변수 또는 동적 매개변수를 지원합니다.

#개요

#1. 문법 설명

포맷터의 기본적인 호출 형식은 다음과 같습니다:

{d.属性:formatter1:formatter2(...)}

예를 들어, 문자열 "JOHN"을 "John"으로 변환하는 경우, 먼저 lowerCase를 사용하여 모든 문자를 소문자로 변환한 다음, ucFirst를 사용하여 첫 글자를 대문자로 만듭니다.

#2. 예시

데이터:

{
  "name": "JOHN",
  "birthday": "2000-01-31"
}

템플릿:

My name is {d.name:lowerCase:ucFirst}. I was born on {d.birthday:formatD(LL)}.

#3. 결과

렌더링 후 출력은 다음과 같습니다:

My name is John. I was born on January 31, 2000.

#상수 매개변수

#1. 문법 설명

많은 포맷터는 하나 이상의 상수 매개변수를 지원합니다. 이 매개변수들은 쉼표로 구분되며, 출력을 수정하기 위해 괄호 안에 포함됩니다. 예를 들어, :prepend(myPrefix)는 텍스트 앞에 "myPrefix"를 추가합니다. 주의: 매개변수에 쉼표나 공백이 포함된 경우, prepend('my prefix')와 같이 작은따옴표로 묶어야 합니다.

#2. 예시

템플릿 예시 (자세한 내용은 각 포맷터의 사용법을 참조하십시오.)

#3. 결과

출력 텍스트 앞에 지정된 접두사가 추가됩니다.

#동적 매개변수

#1. 문법 설명

포맷터는 동적 매개변수도 지원합니다. 이 매개변수들은 점(.)으로 시작하며 따옴표로 묶지 않습니다. 동적 매개변수를 지정하는 방법은 두 가지입니다:

• 절대 JSON 경로: d. 또는 c.로 시작합니다 (루트 데이터 또는 보조 데이터 참조).
• 상대 JSON 경로: 단일 점(.)으로 시작하며, 현재 부모 객체에서 속성을 찾는 것을 나타냅니다.

예를 들어:

{d.subObject.qtyB:add(d.subObject.qtyC)}

상대 경로로도 작성할 수 있습니다:

{d.subObject.qtyB:add(.qtyC)}

상위 레벨(부모 또는 그 이상)의 데이터에 접근해야 하는 경우, 여러 개의 점을 사용할 수 있습니다:

{d.subObject.qtyB:add(..qtyA):add(.qtyC)}

#2. 예시

데이터:

{
  "id": 10,
  "qtyA": 20,
  "subObject": {
    "qtyB": 5,
    "qtyC": 3
  },
  "subArray": [{
    "id": 1000,
    "qtyE": 3
  }]
}

템플릿 사용 예시:

{d.subObject.qtyB:add(d.subObject.qtyC)}      // 결과: 8 (5 + 3)
{d.subObject.qtyB:add(.qtyC)}                   // 결과: 8
{d.subObject.qtyB:add(..qtyA):add(.qtyC)}        // 결과: 28 (5 + 20 + 3)
{d.subArray[0].qtyE:add(..subObject.qtyC)}       // 결과: 6 (3 + 3)

#3. 결과

각 예시의 결과는 각각 8, 8, 28, 6입니다.

주의: 사용자 정의 이터레이터나 배열 필터를 동적 매개변수로 사용하는 것은 허용되지 않습니다. 예를 들어:

{d.subObject.qtyB:add(..subArray[i].qtyE)}
{d.subObject.qtyB:add(d.subArray[i].qtyE)}