복수형과 선택형
수량과 애플리케이션 상태에 맞는 문법적으로 완전한 대체 표현을 렌더링하고, 기본으로 사용할 형식을 명시하세요.
“파일 1개가 준비되었습니다”와 “파일 2개가 준비되었습니다”에 해당하는 영어 문장은 명사만 달라지는 것이 아닙니다. 다른 언어에서는 구분 방식도 다릅니다. 선택한 언어로 메시지 전체를 올바르게 표현할 수 있도록 런타임에 완전한 대체 표현을 제공하세요.
수량에 따라 형식 선택하기 #
import { createLingo } from "@lingo.dev/react";
const l = createLingo("en");
const message = l.plural(
2,
{
one: "# file is ready for {name}.",
other: "# files are ready for {name}.",
},
{ context: "Files ready for download", values: { name: "Ana" } },
);이 원문 언어 예제는 2 files are ready for Ana.을 반환합니다. 번역된 카탈로그에서는 활성 로캘의 기수 규칙에 따라 형식이 선택됩니다. one 범주는 문법적 범주이며, 정수 1을 판별하는 보편적인 조건이 아닙니다.
plural(count: number, forms: PluralForms, options)에는 other 형식이 반드시 필요합니다. 선택적으로 사용할 수 있는 범주는 zero, one, two, few, many입니다. 옵션에는 context이 필수이며, 추가 문자열이나 숫자 값이 담긴 맵을 전달할 수 있습니다. #는 개수를 표시합니다. 도우미가 count 인수를 직접 제공하므로, 해당 맵에 count이 있으면 덮어씁니다.
도우미는 zero, one, two, few, many, other 순서로 ICU 메시지를 구성합니다. 추출할 때도 같은 생성기를 사용하므로 속성 순서를 바꿔도 식별자는 달라지지 않습니다. 형식이나 해당 문맥을 바꾸면 식별자가 달라질 수 있습니다. 추출할 수 있도록 형식은 리터럴로 유지하세요.
애플리케이션 값에 따라 형식 선택하기 #
범주가 정확히 일치하는 항목을 선택하려면 select을 사용하세요:
const action = l.select(
"member",
{
admin: "Manage the team",
member: "View your work",
other: "Open your account",
},
{ context: "Primary navigation action for the signed-in account role" },
);위의 l을 사용하면 View your work가 반환됩니다. 알 수 없는 역할에는 other이 사용됩니다. 언어를 바꿔도 선택된 상태가 바뀌지 않도록 admin 같은 애플리케이션 코드는 번역된 표시 레이블과 분리하세요.
select(value: string, forms: SelectForms, options: { context: string }): string에는 other이 반드시 필요합니다. ICU 원문을 구성할 때 형식 키를 알파벳순으로 정렬하며, value 인수를 제공합니다. 이 도우미에는 추가 값을 전달하는 옵션이 없습니다.
ICU 텍스트로 정확한 개수와 서수 표현하기 #
복수형 도우미는 기수 범주를 제공합니다. 정확히 =0에 해당하는 대체 표현이 필요하면 원시 ICU 예제를 사용하세요. 서수를 표현하려면 리터럴 l.text 메시지를 사용하세요:
const position = l.text(
"{position, selectordinal, one {#st} two {#nd} few {#rd} other {#th}}",
{
context: "Finishing position in a ranked result, using English source suffixes",
values: { position: 2 },
},
);영어로 출력되는 결과는 2nd입니다. 대상 템플릿에는 대상 언어에 맞는 표현이 필요합니다. 주변 인터페이스를 번역하더라도 영어 접미사가 다른 언어에까지 적합해지는 것은 아닙니다.
각 대상 언어에서 0, 1, 대표적인 범주를 테스트하고, 알 수 없는 선택 값도 테스트하세요. 생성된 메시지 제약 조건은 text와 rich의 범위를 좁히며, 복수형 및 선택형 도우미는 각각 자체 형식과 옵션 타입을 유지합니다. 추출된 ICU 표현을 살펴보고 각 경우를 렌더링하여 실제로 어떤 문법적 경로가 적용되는지 확인하세요.