스칼라 Dictionary

dictionary 파일 (*.dictionary.ts)은 스칼라에 대한 국제화를 제공합니다. scalarDictionary() 빌더 패턴을 사용하여 스칼라 이름, 필드 레이블, 설명 및 enum 값에 대한 번역을 정의합니다.

이 가이드는 scalarDictionary() 문법, 체이닝 메서드 및 번역 정의를 위한 모범 사례를 다룹니다.

🌐주요 이점

📁파일 구조

Scalar Dictionary 빌더

scalarDictionary() 함수는 플루언트 빌더 패턴을 사용하여 타입 안전한 dictionary를 생성합니다.

method설명

.of((t) => ...)

스칼라 이름과 설명을 정의합니다.

.model<T>((t) => ...)

필드 번역을 정의합니다.

.enum<T>(name, (t) => ...)

Enum 값 번역을 정의합니다.

번역 형식

각 번역은 언어 순서와 일치하는 값 배열과 함께 t() 함수를 사용합니다.

패턴

각 번역은 값 배열과 함께 t() 함수를 사용합니다. 배열 순서는 scalarDictionary()에서 정의한 언어 순서와 일치합니다.

번역 패턴

메서드	목적	예시
`t([...])`	레이블/이름 정의	`t(["Status", "상태"])`
`.desc([...])`	설명 정의	`.desc(["Current status", "현재 상태"])`

완전한 국제화 지원을 위해 레이블과 설명 모두 필요합니다.

price.dictionary.ts

.enum()의 첫 번째 인수는 constant 파일의 enumOf()에서 사용된 이름과 일치해야 합니다. 이렇게 하면 적절한 타입 검사와 런타임 해석이 보장됩니다.

constant.ts

dictionary.ts

중요: enum 이름 문자열은 enumOf()의 첫 번째 인수와 정확히 일치해야 합니다. 예: enumOf("journey", [...])는 .enum<Journey>("journey", ...)가 필요합니다.

타입 안전성을 보장하기 위해 항상 constant 파일에서 타입을 import하세요. 제네릭 파라미터는 모든 필드와 enum 값에 번역이 있도록 강제합니다.

Import 패턴

✓

import type: 타입 전용 import에는 'import type'을 사용하세요. 이렇게 하면 런타임 코드가 포함되지 않습니다.

✓

.model<Type>: 필드 이름에 대한 자동완성을 제공하고 모든 필드가 번역되었는지 검증합니다.

✓

.enum<Type>: enum 값에 대한 자동완성을 제공하고 모든 값이 번역되었는지 검증합니다.

스칼라 dictionary를 정의할 때 다음과 같은 흔한 실수를 피하세요: